home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / unix / ptd204.exe / MANUAL.TXT < prev    next >
Text File  |  1993-11-08  |  134KB  |  3,518 lines
  1.  
  2.  
  3.  
  4.                              PopTerm/NVT 
  5.                           for DOS and Windows
  6.  
  7.                                   
  8.                              User's Guide
  9.                          (ASCII-Only Version)
  10.  
  11.  
  12.                          Rational Data Systems
  13.  
  14.  
  15. Welcome!
  16. ========
  17.  
  18.       The PopTerm/NVT User's Guides are normally delivered in typeset,
  19.       bound, hard copy,  However, to expedite the distribution of the 
  20.       demo version, RDS has supplied this ASCII-only textfile version.
  21.       
  22.       If you would like to receive a hard-copy version of the User's 
  23.       Guide, or if you have  any other questions, please contact:
  24.       
  25.       Rational Data Systems, Inc.
  26.       1050 Northgate Drive
  27.       San Rafael, California 94903
  28.       
  29.       Tel: 415/499-3354
  30.       Tel: 800/743-3054
  31.       FAX: 415/499-8115
  32.  
  33.  
  34. NOTICE
  35.  
  36.       Rational Data Systems, Inc., (RDS) has prepared this manual for 
  37.       use by RDS personnel and customers. The material contained 
  38.       herein is the property of RDS and shall not be reproduced in
  39.       whole or in part without RDS's prior written approval.
  40.  
  41.       Users are cautioned that RDS reserves the right to make changes
  42.       without notice in the specifications and materials contained
  43.       herein and shall not be responsible for any damages (including
  44.       consequential) caused by reliance upon the materials presented.
  45.  
  46.       Software and Documentation Copyright 1992, 1993 
  47.       Rational Data Systems, Inc., and Redwood Technologies. 
  48.       All Rights Reserved.
  49.  
  50.       Portions of this program Copyright 1983-1990 Novell, Inc.
  51.       All Rights Reserved.
  52.  
  53.       ISBN 1-881378-17-9
  54.  
  55.  
  56. Trademarks
  57. ==========
  58.  
  59.       PopTerm is a trademark of Rational Data Systems, Inc. MS-DOS, 
  60.       MS, Microsoft and Microsoft Windows are registered trademarks of
  61.       Microsoft Corporation. IBM is a registered trademark of 
  62.       International Business Machines Corporation. Novell and NetWare
  63.       are registred trademarks of Novell, Inc. Unix is a registered
  64.       trademark of American Telephone and Telegraph.
  65.  
  66.  
  67. Revision History:
  68. =================
  69.  
  70.       Second Edition [2.00] February 1993
  71.  
  72.       Rational Data Systems, Inc.
  73.       San Rafael, California
  74.  
  75.       Tel: 800/743-3054
  76.       Tel: 415/499-3354
  77.       FAX: 415/499-8115
  78.       BBS: 415/499-7628
  79.  
  80.  
  81.  
  82.  
  83.  
  84.                                     Preface
  85.  
  86. Thank You!
  87. ==========
  88.  
  89.       We appreciate your selecting PopTerm/NVT for your terminal
  90.       emulation requirements. Rational Data Systems has tried to make
  91.       PopTerm/NVT the best possible emulator for the NetWare for Unix
  92.       environment. We hope you'll agree that we have succeeded.
  93.  
  94.  
  95. What's Inside
  96. =============
  97.  
  98.       This User's Guide is divided into three sections:
  99.  
  100.          * PopTerm/NVT for MS-DOS
  101.  
  102.          * PopTerm/NVT for Microsoft Windows
  103.  
  104.          * Emulation Issues
  105.  
  106.  
  107.       The first two sections document the unique aspects of each of 
  108.       the two versions of PopTerm/NVT. The third section describes 
  109.       more advanced topics that are common to both versions.
  110.  
  111.  
  112. If You Need Help
  113. ================
  114.  
  115.       If you encounter difficulties which you cannot resolve with the
  116.       help of this User's Guide please contact your NetWare for Unix 
  117.       OEM or Rational Data Systems Tech Support Department:
  118.  
  119.       Rational Data Systems, Inc.
  120.       1050 Northgate Drive
  121.       San Rafael, California 94903  USA
  122.  
  123.       Tel: 800/743-3054 (toll-free in the U.S.)
  124.       Tel: 415/499-3354
  125.       FAX: 415/499-8115
  126.       BBS: 415/499-7628
  127.  
  128.  
  129. End-User License Agreement
  130. ==========================
  131.  
  132.       DO NOT OPEN THIS PACKAGE BEFORE CAREFULLY READING ALL THE TERMS
  133.       OF THIS AGREEMENT. OPENING THE PACKAGE CONTAINING THIS SOFTWARE
  134.       INDICATES YOUR ACCEPTANCE OF THESE TERMS AND CONDITIONS.
  135.  
  136.       If you do not agree to these terms and conditions, return the
  137.       sealed package with all contents unused to the place of purchase 
  138.       and your money will be refunded. No refunds will be given for
  139.       packages which have been opened or for products which have been
  140.       used or are missing components. In return for acquiring a license
  141.       to use the computer program(s) contained herein ("Programs") and
  142.       related documentation supplied by Rational Data Systems, 
  143.       Incorporated ("RDS"), you agree to the following terms and
  144.       conditions:
  145.  
  146.       1.1 SCOPE OF USE. You agree to accept a nonexclusive license
  147.       to use the Programs on one (1) specific single-user computer
  148.       system or network server ("CPU") as appropriate for the 
  149.       license purchased under the conditions set forth below.
  150.  
  151.       1.2 You agree that you will not make or have made, or permit to
  152.       be made, any copies of the Programs or related documentation or
  153.       any portions thereof, except as necessary for backup purposes. 
  154.       You agree that any such backup copies of the Programs shall 
  155.       contain the same proprietary notices (including, but not limited
  156.       to copyright notices) which appear on or in the Programs as 
  157.       delivered by RDS.
  158.  
  159.       2. PROPRIETARY RIGHTS AND OBLIGATIONS. You acknowledge that the
  160.       Programs are proprietary to RDS and licensed to you on a 
  161.       nonexclusive basis.
  162.  
  163.       3. NO OTHER RIGHTS. Except as stated above, this Agreement does not
  164.       grant you any rights to nor shall any rights accrue to you by your
  165.       use under this Agreement of patents, copyrights, trade secrets, 
  166.       trade names, Trademarks (whether registered or unregistered), or
  167.       any other rights, franchises, or licenses in respect of the 
  168.       Programs or related documentation or trademarks.
  169.  
  170.       4. TERM. The license is effective until terminated. You may 
  171.       terminate the license at any time by destroying the software
  172.       and its documentation together with all copies or modifications.
  173.       RDS will have the right to terminate your license immediately if
  174.       you fail to comply with any term or condition of this Agreement.
  175.       You agree upon any such termination you will destroy the software
  176.       and its documentation together with all copies or modifications in
  177.       any form and cease all use of Programs.
  178.  
  179.       5.1 LIMITED WARRANTY. RDS warrants that the unmodified Programs
  180.       contained herein will operate substantially in the manner
  181.       described in the documentation contained herein for a period of
  182.       ninety (90) days from the date they were obtained by you as
  183.       evidenced by a copy of your receipt. RDS warrants that the
  184.       magnetic media upon which the Programs are recorded will be
  185.       free from defects in materials and workmanship under normal use
  186.       and service for the same ninety (90) day period.
  187.  
  188.       RDS's entire liability and your exclusive remedy shall be
  189.       replacement of the Programs which do not meeting RDS's
  190.       Limited Warranty are which returned by you to your place of
  191.       purchase with a copy of your receipt and a written statement of
  192.       the problem(s) encountered. If the Programs have been modified
  193.       in any manner then RDS shall have no responsibility to replace
  194.       the Programs under this Limited Warranty. RDS DOES NOT AND
  195.       CANNOT WARRANT THE PERFORMANCE OR RESULTS THAT MAY BE OBTAINED BY
  196.       USING THE PROGRAMS OR RELATED DOCUMENTATION. THE FOREGOING
  197.       STATES YOUR SOLE AND EXCLUSIVE REMEDY FOR BREACH OF WARRANTY. IN
  198.       PARTICULAR, RDS DISCLAIMS ALL WARRANTIES AS TO PERFORMANCE,
  199.       MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.
  200.  
  201.       5.2 LIMITED LIABILITY. IN NO EVENT WILL RDS BE LIABLE TO YOU FOR
  202.       ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER
  203.       INCIDENTAL OR CONSEQUENTIAL DAMAGES EVEN IF RDS OR ANY RDS
  204.       REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
  205.       DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  206.  
  207.       5.3 Some states do not allow the exclusion of implied warranties
  208.       or limitations on how long an implied warranty may last, or the
  209.       exclusion or limitation of incidental or consequential damages, 
  210.       so the above limitations or exclusions may not apply to you. The
  211.       warranty in Section 5.1 gives you specific legal rights and you
  212.       may also have other rights which vary from state to state.
  213.  
  214.       6. EXPORT. You acknowledge that the laws and regulations of the
  215.       United States restrict the export and re-export of commodities 
  216.       and technical data of United States origin, including the 
  217.       Programs or related documentation in any medium. You agree that
  218.       you will not export or re-export the Programs or related
  219.       documentation in any form without the appropriate United States
  220.       and foreign government licenses. You also agree that your
  221.       obligations pursuant to this section shall survive and continue
  222.       after any termination or expiration of rights under this Agreement.
  223.  
  224.       7. GOVERNING LAW. This Agreement shall be governed in all respects
  225.       by the laws of the United States of America and the State of 
  226.       California as such laws are applied to agreements entered into and
  227.       to be performed entirely within California between California
  228.       residents.
  229.  
  230.       8. ENTIRE AGREEMENT. YOU ACKNOWLEDGE THAT YOU HAVE READ THIS
  231.       AGREEMENT, UNDERSTAND IT AND THAT BY USING THE ENCLOSED PROGRAMS,
  232.       YOU AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS. YOU FURTHER
  233.       AGREE THAT IT IS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE
  234.       AGREEMENT BETWEEN RDS AND YOU WHICH SUPERSEDES ANY PROPOSAL OR
  235.       PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER COMMUNICATIONS
  236.       BETWEEN RDS AND YOU RELATING TO THE SUBJECT MATTER OF THIS
  237.       AGREEMENT. NO VARIATION OF THE TERMS OF THIS AGREEMENT OR ANY
  238.       DIFFERENT TERMS WILL BE ENFORCEABLE AGAINST RDS UNLESS RDS GIVES
  239.       ITS EXPRESS CONSENT, INCLUDING AN EXPRESS WAIVER OF THE TERMS OF
  240.       THIS AGREEMENT, IN A WRITING SIGNED BY RDS.
  241.  
  242.  
  243.       PopTerm/NVT for MS-DOS is one of a family of multi-session
  244.       LAN-based terminal emulation software packages designed
  245.       specifically for use with NetWare for Unix.
  246.       
  247.       PopTerm/NVT for MS-DOS emulates VT-52, VT-102 and VT-220
  248.       terminals on IBM PC, XT, AT, PS/2 and compatible computers under
  249.       MS-DOS.
  250.  
  251.  
  252. Features
  253. ========
  254.  
  255.       PopTerm/NVT for MS-DOS includes the following features:
  256.  
  257.          * VT-xxx Emulation
  258.  
  259.             PopTerm/NVT emulates the important features of Digital
  260.             Equipment's popular VT-52, VT-102 and VT-220 CRTs.
  261.  
  262.          * Integrated NVT
  263.  
  264.             NetWare Virtual Terminal (NVT) is the LAN-based protocol
  265.             for terminal emulation in conjunction with NetWare for Unix.
  266.             While many emulators are NVT compatible, PopTerm/NVT is the
  267.             first emulator to actually include enhanced functionality of
  268.             Novell's NVT.EXE within the emulator itself.
  269.  
  270.          * Multiple Sessions
  271.  
  272.             PopTerm/NVT supports up to ten simultaneous sessions.
  273.             These sessions may be on a single or separate NetWare for 
  274.             Unix servers. PopTerm/NVT accomplishes this without the 
  275.             need for additional software on the NetWare for Unix server.
  276.             A single keystroke allows you to switch from one session to
  277.             any other. The screen for each session is saved and restored
  278.             when you return to that session.
  279.  
  280.          * Small Size
  281.  
  282.             PopTerm/NVT requires less than 100k bytes under MS-DOS. This
  283.             includes the memory normally occupied by NVT.EXE which is
  284.             not required by PopTerm/NVT, making PopTerm/NVT much smaller
  285.             than other NVT-based packages.
  286.  
  287.          * Memory-Resident
  288.  
  289.             PopTerm/NVT for MS-DOS is small enough to run as a memory-
  290.             resident (TSR) program. PopTerm/NVT can even be loaded into
  291.             memory above 640k, giving the user memory-resident emulation
  292.             without consuming valuable DOS memory.
  293.  
  294.          * Hot-Key Activation
  295.  
  296.             When installed as an MS-DOS TSR, PopTerm/NVT can be activated
  297.             at any time by pressing the Alt and = keys. The PC screen 
  298.             then switches instantly between DOS and terminal mode. The
  299.             underlying application's screen is fully saved and restored.
  300.  
  301.          * Internationalization
  302.  
  303.             PopTerm/NVT is a truly international product. In addition to 
  304.             support for most character sets, a single keystroke instantly
  305.             switches PopTerm/NVT's prompts and messages between most 
  306.             common languages. PopTerm/NVT's extensive help facility is
  307.             likewise multilingual.
  308.  
  309.          * Remappable Keyboard
  310.  
  311.             To support applications which expect a variety of keyboard
  312.             layouts as well as the unique requirements of many non-U.S.
  313.             keyboards, PopTerm/NVT supports redefining or remapping of
  314.             most of the keyboard character codes.
  315.    
  316.          * Network Ready
  317.    
  318.             PopTerm/NVT's simple installation and management procedures
  319.             are designed for the multi-user environment. Individual 
  320.             session files retain host-specific data and each user's
  321.             preferences for colors, languages and other emulation
  322.             attributes.
  323.    
  324.          * Text File Logging and Transmission
  325.    
  326.             PopTerm/NVT can capture text files to disk as they are
  327.             received, and transmit disk files to the remote computer as
  328.             though they were typed from the keyboard.
  329.    
  330.          * Restrictions
  331.    
  332.             While PopTerm supports all of the most commonly used
  333.             functions of the DEC VTxxx terminals, it does not support
  334.             downloadable fonts or the DEC Technical Character Set.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.                                  Installation
  341.  
  342. Introduction
  343. ============
  344.  
  345.       The PopTerm/NVT files may be stored on each individual PC
  346.       workstation or kept on your NetWare file server. The software
  347.       will operate the same in either case.
  348.  
  349.        Advantages of keeping PopTerm/NVT on each PC include:
  350.  
  351.          * a simple installation process; and
  352.  
  353.          * complete privacy of configuration data and session
  354.            files.
  355.  
  356.       On the other hand, if you store PopTerm/NVT on a network file
  357.       server:
  358.  
  359.          * all users can share a single copy of the program and
  360.            associated files, and
  361.  
  362.          * a system manager can support multiple users without the
  363.            need to make changes at each PC.
  364.  
  365.       If you are already familiar with PopTerm/NVT and want to install
  366.       it on a NetWare server, refer to the Advanced Installation
  367.       Options section later in this manual for more information. The
  368.       following section describes the simplified procedure for
  369.       installation on an individual PC.
  370.  
  371.  
  372. NVT.EXE
  373. =======
  374.  
  375.       Do not load the file NVT.EXE which was supplied by your
  376.       NetWare for Unix OEM. The functions of NVT.EXE are included
  377.       within PopTerm/NVT itself.
  378.  
  379.  
  380.  Installing PopTerm/NVT
  381. =======================
  382.  
  383.     
  384.  
  385.    
  386.   1. Create a directory on your hard drive for PopTerm i.e. C:\POPTERM
  387.  
  388.   2. Copy the files that came from the self-extracting archive to that directory
  389.  
  390.   3. Modify config.sys to make sure FILES are at least 35 and BUFFERS 
  391.      are at least 15
  392.                         FILES=35
  393.                         BUFFERS=15
  394.  
  395.   4. Add your PopTerm directory to your DOS Path statement in your AUTOEXEC.BAT
  396.       
  397.      In order to run PopTerm/NVT, your computer must be able to
  398.      locate the PT.EXE program.  As with all MS-DOS programs, your
  399.      computer will first look in the current directory, then follow your
  400.      search PATH.  Make sure that MS-DOS can find PopTerm/NVT by adding
  401.      C:\POPTERM to the end of your PATH statement in the AUTOEXEC.BAT file.    
  402.  
  403.  
  404.    5. Add the following line to your AUTOEXEC.BAT
  405.                         SET PTDIR=C:\POPTERM
  406.  
  407.       For PopTerm/NVT to  find its session files you must either be in 
  408.       the directory with those session files before you start PopTerm/NVT  
  409.       or you must add the PTDIR variable to your AUTOEXEC.BAT file.  What 
  410.       this does is tell PopTerm/NVT where to find its session files.     
  411.  
  412.  
  413.  
  414. RELEASE.TXT and SEE.EXE
  415. ===================
  416.  
  417.       PopTerm/NVT comes with a utility called SEE.EXE.  This program 
  418.       is used to read the documentation that comes with this demo.  
  419.       To display the PopTerm/NVT RELEASE.TXT file simply type README from a 
  420.       DOS prompt in the POPTERM subdirectory. SEE.EXE allows you to navigate
  421.       through the READ.ME file using the following keys:
  422.  
  423.          * Use the up and down arrows to scroll one line at a time,
  424.            PgUp and PgDown to move and entire screen at a time, and
  425.            Home and End to move to the beginning and end of the entire
  426.            file.
  427.    
  428.          * Press "C" to print or copy all or portions of the file.
  429.    
  430.          * Press "H" to get more help with the use of SEE.EXE.
  431.    
  432.          * Press "ESCape" then you are done reading the RELEASE.TXT file.
  433.  
  434.       -----------------------------------------------------------------
  435.        WARNING!  RELEASE.TXT contains important updates and changes to
  436.                  this User's Guide. The information it contains may be
  437.                  critical to your installation, use of, and success 
  438.                  with PopTerm/NVT. Please read it thoroughly.
  439.       -----------------------------------------------------------------
  440.  
  441.  
  442.  
  443.  
  444.  
  445.                                 Getting Started
  446.  
  447.  
  448. Running PopTerm/NVT
  449. ===================
  450.  
  451.       Once PopTerm/NVT has been properly installed, it is started by
  452.       simply typing "PT".
  453.  
  454.            C>pt
  455.  
  456.       PopTerm/NVT will display the Connection Manager screen.
  457.  
  458.       Select a NetWare for Unix NVT server from among those displayed
  459.       by moving the highlight bar up or down with your cursor keys and
  460.       press <Enter>. You will be presented with the Unix login prompt
  461.       of the server you selected.
  462.       
  463.       That's all there is to it. You're up and running!
  464.  
  465.       ----------------------------------------------------------------
  466.        HINT:  You may need to hit the Enter key once or twice before
  467.               you receive the login prompt.
  468.       ----------------------------------------------------------------
  469.  
  470.  
  471. If No Servers Appear
  472. ====================
  473.  
  474.       If no servers are shown in the list, it is usually attributable
  475.       to one of the following causes.
  476.  
  477.       First, NVT may not be running or may not be configured properly
  478.       on your NetWare for Unix server. See your NetWare for Unix
  479.       documentation for instructions on how to enable NVT using the
  480.       sconsole utility.
  481.  
  482.       Second, the IPX driver on your PC may not be configured properly.
  483.       Can you connect to your NetWare for Unix file server as an
  484.       ordinary NetWare client (i.e., for file and print service)? If
  485.       not, then refer to your NetWare documentation for instructions on
  486.       configuring your IPX and LAN adaptor.
  487.  
  488.       If neither of these suggestions solves the problem, use
  489.       NVT.EXE as a diagnostic tool as described below.
  490.  
  491.  
  492. Testing with NVT.EXE
  493. ====================
  494.  
  495.       Your NetWare for Unix software includes an MS-DOS program called
  496.       NVT.EXE which is used by other terminal emulators to communicate
  497.       with NetWare for Unix's NVT. The functionality of NVT.EXE is
  498.       contained within PopTerm/NVT, so NVT.EXE should not be used with
  499.       PopTerm/NVT. You can, however, use NVT.EXE to test the ability
  500.       to make a connection to the server.
  501.  
  502.       If you are currently running PopTerm/NVT, exit and remove it from
  503.       memory by pressing Alt-R. Locate the NVT.EXE program which was
  504.       supplied with your NetWare for Unix software. Load NVT.EXE from
  505.       the MS-DOS prompt by typing:
  506.  
  507.            NVT
  508.  
  509.       Press Alt-T to bring up the list of available NVT servers. The
  510.       list you see using NVT.EXE should be the same as that displayed
  511.       using PopTerm/NVT.
  512.  
  513.       To unload NVT.EXE, press ESCape to return to the MS-DOS command
  514.       line and enter the following command:
  515.  
  516.            NVT -y
  517.  
  518.       If servers are displayed using NVT.EXE but not with PopTerm/NVT,
  519.       contact Rational Data Systems or your supplier for assistance.
  520.       If no servers are displayed using either NVT.EXE or PopTerm/NVT,
  521.       the problem is not within PopTerm/NVT.
  522.  
  523.  
  524. Session Files
  525. =============
  526.  
  527.       PopTerm/NVT uses session files to store your preferences for each
  528.       connection or session. By default PopTerm/NVT tries to load the
  529.       session file named DEFAULT.SES. Unless you have modified
  530.       DEFAULT.SES it will not contain the name of your NetWare for Unix
  531.       server, and PopTerm/NVT will enter the Connection Manager.
  532.       However, if you have modified DEFAULT.SES using the Control Panel,
  533.       PopTerm/NVT will try to connect to the specified server.
  534.  
  535.  
  536. The Command Line
  537. ================
  538.  
  539.       You can also specify session file names on the command line. For
  540.       example, suppose you have a NetWare for Unix NVT server named
  541.       NVT_ONE. If you create a session file named ONE.SES which
  542.       specifies that name you could start PopTerm/NVT as follows:
  543.  
  544.            C>pt one
  545.  
  546.       This instructs PopTerm/NVT to connect to NVT_ONE as soon as the
  547.       program begins, which is very convenient if you typically use the
  548.       same NetWare for Unix NVT servers over and over again.
  549.  
  550.       -----------------------------------------------------------------
  551.        NOTE:  You should not use the ".SES" file extension. It is 
  552.               always assumed by PopTerm/NVT.
  553.       -----------------------------------------------------------------
  554.  
  555.  
  556. Multiple Sessions
  557. =================
  558.  
  559.       PopTerm/NVT allows you to establish up to ten sessions and to
  560.       switch back and forth between them without losing any data.
  561.       These sessions may all be on the same NetWare for Unix NVT server
  562.       or on different servers.
  563.  
  564.       You can start and stop each session from within PopTerm/NVT, or
  565.       you can specify up to ten sessions on the command line. For
  566.       example:
  567.  
  568.            C>pt one one two
  569.  
  570.       -----------------------------------------------------------------
  571.        NOTE:  The session file ONE.SES is used twice. This would 
  572.               start sessions 1 and 2 on NVT_ONE and session 3 on the 
  573.               server specified in the session file TWO.SES.
  574.       -----------------------------------------------------------------
  575.  
  576.  
  577. Exiting PopTerm/NVT
  578. ===================
  579.  
  580.       When you want to return to MS-DOS you have two options:
  581.  
  582.          * If you press the Alt-R (Remove) key your sessions will be
  583.            terminated, PopTerm/NVT will be removed from memory and 
  584.            you'll be returned to MS-DOS.
  585.    
  586.          * If you press the Alt-X (eXit) key PopTerm/NVT will install
  587.            itself as a memory-resident or TSR program. Your sessions
  588.            will continue to exist (but remain inactive) and you'll be
  589.            be returned to MS-DOS.
  590.  
  591.       -----------------------------------------------------------------
  592.        HINT:  The advantage of leaving PopTerm/NVT as a memory
  593.               resident program is that you can return to it at any
  594.               time by simply pressing the hot-key, typically Alt-=.
  595.               Your current MS-DOS application will be suspended and
  596.               your PopTerm/NVT sessions will continue where they left
  597.               off. You may then toggle back and forth between 
  598.               PopTerm/NVT and MS-DOS using the hot-key.
  599.       -----------------------------------------------------------------
  600.  
  601.       -----------------------------------------------------------------
  602.        WARNING!  PopTerm/NVT will only "pop-up" when the current
  603.                  MS-DOS application is using your display in text 
  604.                  mode. If you are currently running a graphics 
  605.                  application (such as Windows), PopTerm/NVT will 
  606.                  just beep when you press the hot-key.
  607.       -----------------------------------------------------------------
  608.  
  609.  
  610. The /R Option
  611. =============
  612.  
  613.       You can also install PopTerm/NVT as a memory resident program from
  614.       the command line using the /R option:
  615.  
  616.            C>pt /r
  617.  
  618.       -----------------------------------------------------------------
  619.        HINT:  You may even want to include a line like this in your
  620.               AUTOEXEC.BAT file. PopTerm/NVT will then always be
  621.               available, waiting for you to press the hot-key. You can
  622.               also specify session files in your AUTOEXEC.BAT file:
  623.  
  624.                  pt /r bigcpu other1
  625.  
  626.               In this case, connections to each of the NVT servers 
  627.               specified in BIGCPU.SES and OTHER1.SES will be available
  628.               as soon as you press the hot-key.
  629.       -----------------------------------------------------------------
  630.  
  631.  
  632. What's Next?
  633. ============
  634.  
  635.       You'll know when you're in an active session: you will see the
  636.       screen of your Unix application, and your current session number
  637.       (1-10) will be highlighted at the bottom of your screen. You'll
  638.       also see the numbers of any other sessions which are active.
  639.       To switch to another active session, press the Alt-<n> key or
  640.       Alt-F<n> for the number of the session you want to move to. For
  641.       example, to switch to session 2, press Alt-2 or Alt-F2.
  642.  
  643.       To change the parameters of the current session, press Alt-P to
  644.       go to the Control Panel. To start a new session, press Alt-C to
  645.       go to the Connection Manager. See the Alt Keys section for details
  646.       on the other Alt keys that are available.
  647.  
  648.  
  649.  
  650.  
  651.  
  652.                                  On-Line Help
  653.  
  654.       PopTerm/NVT provides on-line help throughout the program.
  655.       Wherever help is available, it can be accessed by pressing the
  656.       Alt-H key.
  657.  
  658.  
  659. Help In Active Sessions
  660. =======================
  661.  
  662.       While in an active session, the 25th line of the display
  663.       indicates which sessions are active and the name of the server to
  664.       which this session is currently attached. When you press Alt-H,
  665.       the 25th line displays the Alt keys that can be used. You can
  666.       continue to press Alt-H and several more lines of Help will be
  667.       displayed. If you leave a Help line on the screen, it will
  668.       disappear in a few seconds.
  669.  
  670.  
  671. Help in the Connection Manager
  672. ==============================
  673.  
  674.       In the Connection Manager, all of the important keys are
  675.       indicated at the bottom three lines of the display.
  676.  
  677.  
  678. Help in the Control Panel
  679. =========================
  680.  
  681.       There is help available for each field in the Control Panel. The
  682.       bottom three lines display general help for using the Control
  683.       Panel. When Alt-H is pressed, specific information is available
  684.       for the field that is currently highlighted.
  685.  
  686.  
  687.  
  688.  
  689.  
  690.                             The Connection Manager
  691.  
  692.  
  693. What it Does
  694. ============
  695.  
  696.       The Connection Manager screen is used to select a server to start
  697.       a new session.
  698.  
  699.  
  700. Getting There
  701. =============
  702.  
  703.       If you start PopTerm/NVT without specifying one or more session
  704.       files, you will automatically see the Connection Manager. If you
  705.       are in an active session and want to start another, press Alt-C.
  706.  
  707.  
  708. New Sessions
  709. ============
  710.  
  711.       There are two ways to start a session from the Connection
  712.       Manager. The first is to use the Up and Down arrow keys to
  713.       choose a server name, and then press Enter. The program will
  714.       immediately attempt to connect you to the server and, if
  715.       successful, you will be at the Unix login prompt.
  716.  
  717.       The second way to establish a new session is to load a session
  718.       file. To do this, press Alt-L in the Connection Manager. Then
  719.       enter the name of the session file you wish to load. The program
  720.       will then attempt to connect to the server named in that session
  721.       file. If there is no server named in the file or if the
  722.       connection is not successful, an error message will appear and
  723.       you will remain in the Connection Manager. Even if the
  724.       connection is unsuccessful, the terminal settings from the new
  725.       session file will become the default settings for any new
  726.       sessions.
  727.  
  728.  
  729.  
  730.  
  731.  
  732.                                The Control Panel
  733.  
  734. What it Does
  735. ============
  736.  
  737.       The PopTerm/NVT Control Panel provides the user with an easy,
  738.       on-line way of changing terminal settings and colors, selecting
  739.       international character sets, and entering function key macros.
  740.       The user can save these settings to a session file, which can be
  741.       recalled at a later time.
  742.  
  743.  
  744. Getting There
  745. =============
  746.  
  747.       The Control Panel is accessed by pressing Alt-P while in an
  748.       active session or from the Connection Manager. When you enter
  749.       the Control Panel, the settings that are displayed are the
  750.       current settings for the current active session. Anything that
  751.       is changed in the Control Panel, except the Server Name, will be
  752.       immediately reflected in the current session when you return to
  753.       the session.
  754.  
  755.  
  756. Saving Sessions
  757. ===============
  758.  
  759.       You can save the current settings to a session file by pressing
  760.       Alt-S. Enter the name of the file (without the .SES extension),
  761.       and it will be saved in the directory specified by the PTDIR
  762.       environment variable.
  763.  
  764.  
  765. Loading Sessions
  766. ================
  767.  
  768.       You can load a session file by pressing Alt-L and entering the
  769.       name of the file, again without the .SES extension. The settings
  770.       from that session file will become the current settings. The
  771.       name of the last session file that was loaded or saved will
  772.       appear at the top of the Control Panel.
  773.  
  774.  
  775. Fields
  776. ======
  777.  
  778.    Server Name
  779.       Enter the NetWare NVT Server Name of up to 48 characters. If the
  780.       Server Name is changed in the Control Panel it will not affect
  781.       the current session. The field is provided here only for the
  782.       purposes of building session files containing Server Names.
  783.  
  784.    Terminal Type
  785.       Enter the type of terminal emulation desired. The following
  786.       types are supported:
  787.  
  788.          VT52         DEC VT-52
  789.          VT102        DEC VT-102
  790.          VT102/AC     DEC VT-102 plus ANSI Color Support
  791.          VT220-7      DEC VT-220 in 7-bit mode
  792.          VT220-8      DEC VT-220 in 8-bit mode
  793.  
  794.       The setting should reflect the equivalent TERM variable value on
  795.       your Unix server.
  796.  
  797.    Columns
  798.       Indicate whether to display in 80 column or virtual 132 column
  799.       mode. If 132 column is selected, the screen will scroll
  800.       horizontally as you type or when you use the Ctrl Left-Arrow and
  801.       Ctrl Right-Arrow keys.
  802.  
  803.    Screen Mode
  804.       Select Normal or Reverse. If reverse is selected, then the
  805.       foreground and background colors are reversed.
  806.  
  807.    Character Wrap
  808.       Select Yes if you want characters to wrap around to the next line
  809.       whenever you write to the last column.
  810.  
  811.    Automatic Linefeed
  812.       Select Yes if you want each carriage return that is sent to the
  813.       host to be followed by a line feed.
  814.  
  815.    Cursor Type
  816.       Select either a Block or Underline cursor type. The cursor you
  817.       select will be used in the Control Panel as well as in the
  818.       current active session.
  819.  
  820.    Key Click
  821.       Select Yes if you want an audible click with each keystroke.
  822.  
  823.    Margin Bell
  824.       Select Yes if you want PopTerm/NVT to make a sound whenever you
  825.       are 8 characters from the end of a line.
  826.  
  827.    Scrolling Speed
  828.       Select a scrolling speed with 5 being the fastest and 1 the
  829.       slowest.
  830.  
  831.    Foreground Color
  832.       Select a foreground color for the current session. If you select
  833.       MONO, the foreground will be set to white, the background will be
  834.       black and monochrome underlining will be enabled.
  835.  
  836.    Background Color
  837.       Select a background color for the current session.
  838.  
  839.    Underline Color
  840.       Select a color to use to replace underlining on color monitors.
  841.  
  842.    Tabs
  843.       Press Enter at the tab field to display the tab array. Use the
  844.       arrow keys to move left and right. Enter a Space to delete a
  845.       tab. Enter a 'T' to set a tab. Alt-C will clear all tabs.
  846.       Alt-D will display the default tabs which start in column 9 and
  847.       set a tab every 8 columns. The tabs that are set will
  848.       immediately affect the current session.
  849.  
  850.    Language
  851.       Select the language in which all help and prompts will be
  852.       displayed.
  853.  
  854.    Character Set
  855.       Select the National Replacement Character Set.
  856.  
  857.    Printer
  858.       Select the printer port for this session.
  859.  
  860.    Answer Back
  861.       Enter a message to be returned to the host whenever a Read Status
  862.       request is received from the host.
  863.  
  864.    Default Log File
  865.       Enter the name of a file to which data will be logged to while in
  866.       an active session.
  867.  
  868.    Macros 1-6
  869.       The macros are messages of up to 30 characters each that are sent
  870.       to the host whenever the macro keys, Ctrl-Shift-F1 through
  871.       Ctrl-Shift-F6 are pressed.
  872.  
  873.       -----------------------------------------------------------------
  874.        HINT: You can include control characters in the macros by typing
  875.              the caret, "^" (Shift-6), followed by a letter. For
  876.              example, if you enter the following as macro 5:
  877.  
  878.                  This is a bell.^G
  879.  
  880.              then whenever you press Ctrl-Shift-F5, PopTerm/NVT will
  881.              send "This is a bell." followed by the control-G character
  882.              (ASCII value 7). If you want to send ESCape sequences to
  883.              the host, you can enter "^[" (caret, followed by left 
  884.              square bracket) to place an ESCape character in a macro.
  885.       -----------------------------------------------------------------
  886.  
  887.       -----------------------------------------------------------------
  888.        NOTE:  The macro keys may be remapped.  Refer to the section in
  889.               this manual on keyboard remapping for more information.
  890.       -----------------------------------------------------------------
  891.  
  892.  
  893.  
  894.  
  895.  
  896.                          Advanced Installation Options
  897.  
  898.  
  899.       This section is intended for system managers and network managers
  900.       who are responsible for installing and supporting a NetWare for
  901.       Unix NVT server in addition to PopTerm/NVT.
  902.  
  903.  
  904. Installing PopTerm/NVT on a NetWare Server
  905. ==========================================
  906.  
  907.       If you are installing PopTerm/NVT on a file server, each user can
  908.       have his own directory for session files, or session files can be
  909.       shared. If users will share session files, set the PTDIR
  910.       environment variable to this directory name. If each user will
  911.       have his own session file directory, set PTDIR to the particular
  912.       directory for each user. You can do this by adding PTDIR to each
  913.       user's login script on the server, or by adding it to each user's
  914.       AUTOEXEC.BAT file on each workstation.
  915.       
  916.       For example, if users will share session files in the
  917.       F:\PUBLIC\POPTERM directory, add
  918.  
  919.            SET PTDIR=F:\PUBLIC\POPTERM
  920.  
  921.       to each user's login script or AUTOEXEC.BAT file.
  922.  
  923.  
  924.  
  925.  
  926.  
  927.                         Running Under Microsoft Windows
  928.  
  929. Introduction
  930. ============
  931.  
  932.       Because IPX is not designed to work in a multi-tasking
  933.       environment such as Windows or the MS-DOS DOSSHELL, you may need
  934.       to use additional modules to run PopTerm/NVT in a DOS session
  935.       under Windows 3.x or other task switching environments.
  936.  
  937.  
  938. TBMI and TASKID
  939. ===============
  940.  
  941.       TBMI2.COM is a DOS TSR which is loaded prior to starting Windows.
  942.       TBMI stands for Task-switched Buffer Manager for IPX and was
  943.       created to provide multi-tasking capabilities to IPX and SPX
  944.       programs. Another TSR, TASKID.COM, may also be needed, along
  945.       with an older version of TBMI, depending upon your configuration.
  946.  
  947.          * Windows 3.1 in 386 Enhanced Mode:
  948.  
  949.             No drivers or other changes are need for this
  950.             configuration.
  951.  
  952.          * Windows 3.1 in Standard or Real Mode, or Windows 3.0 in
  953.            Standard or Real Mode with DOS 5.0 or greater:
  954.  
  955.             Before starting Windows, load TBMI2.COM which can be found 
  956.             in your \POPTERM directory. After exiting Windows, run
  957.             TBMI2 with the /U option to unload it from memory. To do all
  958.             of this from a batch file, see "Loading TBMI* from a Batch
  959.             File," later in this section.
  960.  
  961.          * Windows 3.0 in 386 Enhanced Mode:
  962.  
  963.             If the network adaptor in your computer is set for interrupt 
  964.             (IRQ) 2, or IRQ 9 or greater, copy the file, VPICDA.386, from
  965.             \POPTERM to \WINDOWS\SYSTEM, and replace VPICID.386 with
  966.             VPICDA.386 by editing your SYSTEM.INI file as follows:
  967.  
  968.               [386Enh]
  969.               ;device=*vpicd
  970.               device=vpicda.386
  971.  
  972.          * Windows 3.0 in Standard or Real Mode, DOS version 4.x
  973.            or earlier:
  974.  
  975.             Before starting Windows, load TBMI.COM which can be found
  976.             in your \POPTERM directory. After exiting Windows, run TBMI
  977.             with the /U option to unload it from memory. To do all of
  978.             this from a batch file, see "Loading TBMI* from a Batch 
  979.             File," later in this section.
  980.  
  981.  
  982.       TASKID.COM provides information to TBMI as to which DOS session
  983.       it is receiving information from, and must be loaded prior to
  984.       running POPTERM.EXE in a DOS session. A batch file, PTWIN.BAT,
  985.       is used to run PopTerm/NVT under Windows, and must be edited to
  986.       call TASKID. Remove the "REM " keywords on the TASKID lines.
  987.  
  988.  
  989. Loading TBMI* from a Batch File
  990. ===============================
  991.  
  992.       If you are required to run TBMI2.COM or TBMI.COM, you will find
  993.       it helpful to create a batch file which loads it, starts Windows,
  994.       and then unloads it when you exit Windows. Here is what the
  995.       batch file should look like:
  996.  
  997.            C:\POPTERM\TBMI2 
  998.            C:\WINDOWS\WIN
  999.            C:\POPTERM\TBMI2 /U
  1000.  
  1001.       Change the paths as required if your files are located elsewhere.
  1002.       If you already have a batch file to start Windows, add the lines
  1003.       containing TBMI2 to it.
  1004.  
  1005.       If you need to use TBMI.COM instead of TBMI2.COM, edit the batch
  1006.       file to remove the "2" from each line.
  1007.  
  1008.  
  1009. PIF Files
  1010. =========
  1011.  
  1012.       Be aware that PIF files have a setting for the Application
  1013.       Shortcut Key (ASK). Pressing this key when the program is
  1014.       running causes it to become the foreground task. The ASK may be
  1015.       assigned automatically by Windows when you create a PIF file.
  1016.       This key will always be an Alt- or Ctrl- combination which may
  1017.       conflict with one used by PopTerm/NVT. For example, if your PIF
  1018.       file's ASK is set for Alt-D, you will not be able to press Alt-D
  1019.       within PopTerm/NVT to disconnect.
  1020.  
  1021.       If you find that an Alt- or Ctrl- combination doesn't work in
  1022.       PopTerm/NVT DOS under Windows, check the PIF file being used to
  1023.       see the setting of the ASK. Your best bet is to set it to
  1024.       disable the ASK. If you do use it, select an Alt- combination
  1025.       not used by PopTerm/NVT.
  1026.  
  1027.       -----------------------------------------------------------------
  1028.        WARNING!  Remember, if you do not create a PIF file for
  1029.                  PopTerm/NVT, it will use the _DEFAULT.PIF file. See
  1030.                  your Windows manual for more information on PIF files
  1031.                  and the Application Shortcut Key.
  1032.       -----------------------------------------------------------------
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.                              The PopTerm/NVT Files
  1039.  
  1040.  
  1041.       There are several types of files used with PopTerm/NVT. Each
  1042.       file type has a unique DOS extension. The following describes
  1043.       each of the filetypes in detail.
  1044.  
  1045.  
  1046. PopTerm (PT.EXE)
  1047. ================
  1048.  
  1049.       PT.EXE should be placed in a directory within your DOS PATH or
  1050.       within a Search directory if you are using the NetWare file
  1051.       services.
  1052.  
  1053.  
  1054. Session Files (*.SES)
  1055. =====================
  1056.  
  1057.       Session files contain a server name, terminal settings, and any
  1058.       other information that can be entered in the Control Panel.
  1059.       Session files are created by pressing Alt-S, Save Session, while
  1060.       in the Control Panel. All of the settings for the current
  1061.       session will be saved in the session file. The session files
  1062.       will be saved in the directory specified by the PTDIR environment
  1063.       variable, or if PTDIR is not defined, in the directory you were
  1064.       in when PopTerm/NVT was started.
  1065.  
  1066.       A new session file can be loaded for the current session by
  1067.       entering a file name in the session file Name field. The
  1068.       settings from that session file will become the new settings for
  1069.       the current session.
  1070.  
  1071.       PopTerm/NVT is installed with a default session file which is
  1072.       called DEFAULT.SES. Whenever PopTerm/NVT is started, if no
  1073.       session files are indicated on the command line, the program will
  1074.       load the default session file and attempt to establish a session
  1075.       with the server named in that file. You can change the settings
  1076.       and the server name in the default session file by selecting Save
  1077.       Session in the Control Panel, and saving the session to file name
  1078.       DEFAULT.
  1079.  
  1080.  
  1081. Prompt Files (PT-PROMP.*)
  1082. =========================
  1083.  
  1084.       PopTerm/NVT includes prompt files in a number of different
  1085.       languages. All of the prompts on the screen will appear in the
  1086.       language that is currently selected. You can change the language
  1087.       for the prompts at any time by changing the Language field in the
  1088.       Control Panel for the current session. The language can be set
  1089.       on a per session basis.
  1090.  
  1091.       PopTerm/NVT will first search for the prompt files in the same
  1092.       directory as the PT.EXE file. If the prompt files are not found
  1093.       there, the program will search in the directory specified by the
  1094.       PTDIR environment variable, or if PTDIR is not defined, in the
  1095.       directory you were in when PopTerm/NVT was started.
  1096.  
  1097.       If the prompt file for the language that you select cannot be
  1098.       found, the prompts will remain in the last language that was
  1099.       selected. If no prompt files can be found on startup, all
  1100.       prompts will default to English.
  1101.  
  1102.  
  1103. Help Files (PT-HELP.*)
  1104. ======================
  1105.  
  1106.       PopTerm/NVT includes help files in a number of different
  1107.       languages. All of the help messages will appear in the language
  1108.       that is currently selected. The language for the help is changed
  1109.       whenever a new language is selected in the Control Panel.
  1110.       PopTerm/NVT will first search for the help files in the same
  1111.       directory as the PT.EXE file. If the help files are not found
  1112.       there, the program will search in the directory specified by the
  1113.       PTDIR environment variable, or if PTDIR is not defined, in the
  1114.       directory you were in when PopTerm/NVT was started.
  1115.       If the help file for the language that you select cannot be
  1116.       found, no help messages will appear in the Connection Manager or
  1117.       the Control Panel.
  1118.  
  1119.  
  1120. Image Files (*.PTI)
  1121. ===================
  1122.  
  1123.       Image files are temporary files that are created by PopTerm/NVT
  1124.       whenever a new session is established. The image filenames are
  1125.       of the form PTnnnn.PTI where nnnn is a 4 digit number, e.g.,
  1126.       PT0005.PTI. Whenever you switch sessions, the screen image, as
  1127.       well as all of the terminal settings for the session you are
  1128.       switching from, will be saved to an image file.
  1129.  
  1130.       Image files will be created in the directory specified by the
  1131.       PTDIR environment variable, or if PTDIR is not defined, in the
  1132.       directory you were in when PopTerm/NVT was started.
  1133.  
  1134.       Whenever PopTerm/NVT is started, the program will attempt to
  1135.       delete all image files that are found. If the specified
  1136.       directory is on a NetWare server, image files that are in use by
  1137.       another user will not be deleted. If you change the PTDIR
  1138.       variable, it is possible that image files may not be deleted from
  1139.       the old directory. You may attempt to delete *.PTI files
  1140.       whenever you wish, since any image files that are in use will not
  1141.       be deleted.
  1142.  
  1143.  
  1144. Buffer Files (*.PTB)
  1145. ====================
  1146.  
  1147.       Buffer files are temporary files used by PopTerm/NVT to save any
  1148.       data in the local NVT Network buffers whenever you switch
  1149.       sessions or go to the Control Panel or Connection Manager. A
  1150.       buffer file will only be created if data is flowing from the host
  1151.       at the time the switch takes place. The data will then be
  1152.       displayed on the screen when you switch back into the original
  1153.       session. The buffer file will then be deleted.
  1154.  
  1155.       The buffer files are of the form PTnnnn.PTB where nnnn is a 4
  1156.       digit number, e.g., PT0005.PTB. Buffer files will be created in
  1157.       the directory specified by the PTDIR environment variable, or if
  1158.       PTDIR is not defined, in the directory you were in when
  1159.       PopTerm/NVT was started.
  1160.  
  1161.       -----------------------------------------------------------------
  1162.        HINT:  It is possible that buffer files may not get deleted 
  1163.               from a directory if a user turns off his computer before
  1164.               switching back to the session in which the buffer file 
  1165.               was created. If you find buffer files on a NetWare server,
  1166.               you should only delete those files that are at least one 
  1167.               day old.
  1168.       -----------------------------------------------------------------
  1169.  
  1170.  
  1171. UNLOCK.EXE
  1172. ==========
  1173.  
  1174.       The UNLOCK.EXE program allows Rational Data Systems technical
  1175.       support personnel to upgrade the licensing parameters for
  1176.       simultaneous user and server counts via telephone or fax.
  1177.  
  1178.       -----------------------------------------------------------------
  1179.        NOTE:  The UNLOCK.EXE program must be located in the same
  1180.               directory as PT.EXE at the time UNLOCK.EXE is run.
  1181.       -----------------------------------------------------------------
  1182.  
  1183.  
  1184. Map Source Files (*.SRC)
  1185. ========================
  1186.  
  1187.       These are keyboard map source files. 
  1188.  
  1189.  
  1190. Keyboard Map Files (*.MAP)
  1191. ==========================
  1192.  
  1193.       These are the compiled versions of .SRC files. They are the map
  1194.       files actually used by PopTerm/NVT. 
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.                             Special Configurations
  1201.  
  1202.  
  1203.       There are five options to PopTerm/NVT that may be used for
  1204.       individual workstations. This is done by setting the PTCFG
  1205.       environment variable on the workstation. Each of the options 
  1206.       is separated by a space.
  1207.  
  1208.       For example, the following specifies the MONO option and changes
  1209.       the Hotkey to Ctrl-Alt-[:
  1210.  
  1211.            set PTCFG=MONO HOTKEY-26,12
  1212.  
  1213.       -----------------------------------------------------------------
  1214.        NOTE:  There must be a space between each option and there must
  1215.               be no spaces within the HOTKEY option.
  1216.       -----------------------------------------------------------------
  1217.  
  1218.       -----------------------------------------------------------------
  1219.        HINT:  You can add this command to your AUTOEXEC.BAT file.
  1220.       -----------------------------------------------------------------
  1221.  
  1222.  
  1223.    MONO
  1224.       On some PC's the graphics card does not properly indicate the
  1225.       presence of a monochrome monitor. If you have a monochrome PC
  1226.       and PopTerm/NVT does not seem to display properly in the Control
  1227.       Panel or Connection Manager, use the MONO option and the program
  1228.       will force the display to be monochrome.
  1229.  
  1230.    INT10
  1231.       PopTerm/NVT uses direct writes to video memory in order to
  1232.       increase speed. On some PC's this may not work properly. If
  1233.       you are having problems with displays in PopTerm/NVT, try the
  1234.       INT10 option. This is the standard way to display data on the
  1235.       screen, but it will slow down the display somewhat.
  1236.  
  1237.    MAXSESS
  1238.       PopTerm/NVT normally supports up to ten simultaneous sessions.
  1239.       However as these sessions sometimes consume valuable server
  1240.       resources, some users and system managers may want to restrict
  1241.       this to a lower number. This can be done using the MAXSESS-
  1242.       option which is always followed by precisely one digit in the
  1243.       range 1..9. For example, the following will restrict PopTerm/NVT
  1244.       to at most three simultaneous sessions:
  1245.  
  1246.            SET PTCFG=MAXSESS-3
  1247.  
  1248.    NOPAN
  1249.       PopTerm/NVT pans active session screens in from the left and
  1250.       right, and rolls the Control Panel and Connection Manager in from
  1251.       the top. If you would prefer to turn off the panning feature,
  1252.       set the NOPAN option.
  1253.  
  1254.    HOTKEY
  1255.       PopTerm/NVT comes with the Hotkey set to Alt-=. When the program
  1256.       is left resident in memory, pressing the Hotkey will switch you
  1257.       back into the program. Some applications, however, may use
  1258.       Alt-=. If the Hotkey is set to Alt-=, then the application will
  1259.       never see that that key was pressed.
  1260.  
  1261.       This HOTKEY option allows you to set the Hotkey to a combination
  1262.       of keys that will not be used by any of your applications. To
  1263.       select a new Hotkey, you will need to determine the combination
  1264.       of the shift keys and the regular key that you wish to use. See
  1265.       the table below for the numeric values to use. Note that you add
  1266.       the numeric values of all of the shift keys you select.
  1267.  
  1268.       The syntax of the HOTKEY option is as follows:
  1269.  
  1270.            HOTKEY-<regular_key>,<shift_key(s)>
  1271.  
  1272.       For example, suppose you want to use Ctrl-Alt-[ as your Hotkey.
  1273.       First find the '[' key in the Regular Key Table. It has a
  1274.       numeric value of 26. Then find the Ctrl and Alt keys in the
  1275.       Shift Key Table. These keys have values 4 and 8 respectively.
  1276.       Add the shift key values together to get 12. The PTCFG option
  1277.       for the Hotkey would then be
  1278.  
  1279.            HOTKEY-26,12
  1280.  
  1281.       -----------------------------------------------------------------
  1282.        NOTE:  You cannot use any of the PopTerm/NVT Alt keys as your 
  1283.               Hotkey. The easiest way to avoid this is not to use the
  1284.               Alt key followed by a letter, number, or function key. 
  1285.               For example Alt-[ would be fine, but Alt-F1 or Alt-P
  1286.               would not.
  1287.       -----------------------------------------------------------------
  1288.  
  1289.  
  1290. Regular Key Table
  1291. =================
  1292.  
  1293.       The following table lists the regular key values to be used when
  1294.       changing the hot key value via the HOTKEY option:
  1295.  
  1296.               Key            Value
  1297.               --------------------
  1298.                ESC             1
  1299.                1               2
  1300.                2               3
  1301.                3               4
  1302.                4               5
  1303.                5               6
  1304.                6               7
  1305.                7               8
  1306.                8               9
  1307.                9              10
  1308.                0              11
  1309.                -              12
  1310.                =              13
  1311.                Backspace      14
  1312.                Tab            15
  1313.                Q              16
  1314.                W              17
  1315.                E              18
  1316.                R              19
  1317.                T              20
  1318.                Y              21
  1319.                U              22
  1320.                I              23
  1321.                O              24
  1322.                P              25
  1323.                [              26
  1324.                ]              27
  1325.                Enter          28
  1326.                A              30
  1327.                S              31
  1328.                D              32
  1329.                F              33
  1330.                G              34
  1331.                H              35
  1332.                J              36
  1333.                K              37
  1334.                L              38
  1335.                ;              39
  1336.                '              40
  1337.                `              41
  1338.                \              42
  1339.                Z              44
  1340.                X              45
  1341.                C              46
  1342.                V              47
  1343.                B              48
  1344.                N              49
  1345.                M              50
  1346.                ,              51
  1347.                .              52
  1348.                /              53
  1349.                PrtSc          55
  1350.                F1             59
  1351.                F2             60
  1352.                F3             61
  1353.                F4             62
  1354.                F5             63
  1355.                F6             64
  1356.                F7             65
  1357.                F8             66
  1358.                F9             67
  1359.                F10            68
  1360.                Home           71
  1361.                Up             72
  1362.                PgUp           73
  1363.                Minus          74
  1364.                Left           75
  1365.                Right          77
  1366.                End            79
  1367.                Down           80
  1368.                PgDn           81
  1369.                Ins            82
  1370.                Del            83
  1371.  
  1372.       
  1373. Shift Key Table
  1374. ===============
  1375.  
  1376.       The following table lists the shift key values to be used when
  1377.       changing the hot key via the HOTKEY option:
  1378.  
  1379.               Key            Value
  1380.               --------------------
  1381.                Right Shift     1
  1382.                Left Shift      2
  1383.                Ctrl            4
  1384.                Alt             8
  1385.                Scroll Lock    16
  1386.                Num Lock       32
  1387.                Caps Lock      64
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.                                Alt Key Reference
  1394.  
  1395.  
  1396. In All Situations
  1397. =================
  1398.  
  1399.    Alt-H
  1400.       Help
  1401.  
  1402.    Alt-R
  1403.       Exit PopTerm/NVT and remove the program from memory.
  1404.  
  1405.    Alt-X
  1406.       Exit PopTerm/NVT and leave the program resident in memory. If the
  1407.       Hotkey is pressed while in the program, it is the same as
  1408.       pressing Alt-X.
  1409.  
  1410.  
  1411.  
  1412. While in an Active Session
  1413. ==========================
  1414.  
  1415.    Alt-P
  1416.       Go to the Control Panel.
  1417.  
  1418.    Alt-C
  1419.       Go to the Connection Manager.
  1420.  
  1421.    Alt-F1..Alt-F10
  1422.       Switch to session 1 through 10. If no session is open for the
  1423.       number indicated, no switch will occur. You can also use the
  1424.       Alt-1 through Alt-0 keys on the main keyboard for the same
  1425.       purpose.
  1426.  
  1427.       -----------------------------------------------------------------
  1428.        NOTE:  These keys may be remapped. Refer to the section in
  1429.               this manual on keyboard remapping for more information.
  1430.       -----------------------------------------------------------------
  1431.  
  1432.    Alt-D
  1433.       Disconnect from the current session. If other sessions are
  1434.       active, then a switch will occur to another session after the
  1435.       disconnection. If no other sessions are active, then the
  1436.       Connection Manager will appear.
  1437.  
  1438.    Alt-L
  1439.       Log to a file. Enter a file name to to which PopTerm/NVT will
  1440.       copy all characters received. The word 'Log' will appear on the
  1441.       25th line to indicate that logging is active. Press Alt-L again
  1442.       to turn logging off.
  1443.  
  1444.       -----------------------------------------------------------------
  1445.        HINT:  The logging facility is often useful in determining 
  1446.               exactly what byte sequences are being sent to
  1447.               PopTerm/NVT.
  1448.       -----------------------------------------------------------------
  1449.  
  1450.    Alt-T
  1451.       Transmit a file. Enter a file name. The program will then send
  1452.       the data in the file to the host as if you had typed the data.
  1453.  
  1454.    Alt-O
  1455.       Send all data only to the printer. No characters will appear on
  1456.       the main screen while in this mode. The message 'PrO' will
  1457.       appear on the 25th line. Press Alt-O again to return to the
  1458.       screen only mode.
  1459.  
  1460.    Alt-N
  1461.       Send all data to the printer and the screen. The message 'Pr'
  1462.       will appear on the 25th line. Press Alt-N again to return to the
  1463.       screen only mode.
  1464.  
  1465.  
  1466. While in the Connection Manager
  1467. ===============================
  1468.  
  1469.    Alt-P
  1470.       Go to the Control Panel.
  1471.  
  1472.    Alt-L
  1473.       Load a session file. Enter a session file name. This option
  1474.       will then load that session file and attempt to connect to the
  1475.       server named in that file.
  1476.  
  1477.    Esc
  1478.       Return to the active session.
  1479.  
  1480.  
  1481.  
  1482. While in the Control Panel
  1483. ==========================
  1484.  
  1485.    Alt-L
  1486.       Load a session file. Enter the session file name. The terminal
  1487.       settings for the current session will be changed to those in the
  1488.       new session file.
  1489.  
  1490.    Alt-S
  1491.       Save a session file. Enter the session file name. If the file
  1492.       exists, you will be asked whether you wish to overwrite it. All
  1493.       of the current terminal settings, including the server name, will
  1494.       be saved in the session file.
  1495.  
  1496.    ESCape
  1497.       If you entered the Control Panel from an active session, ESCape
  1498.       will return you to the session. If you entered from the
  1499.       Connection Manager, then ESCape will return you there.
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.                                 Error Messages
  1506.  
  1507.  
  1508.       The following provides a more detailed explanation of error
  1509.       messages which are generated by PopTerm/NVT. They are presented
  1510.       alphabetically.
  1511.  
  1512.  
  1513.    Access denied
  1514.       When sharing files on a NetWare Server it is possible that you
  1515.       will try to access a file for which you do not currently have
  1516.       reading or writing privileges. Contact your NetWare systems
  1517.       administrator to resolve the problem.
  1518.  
  1519.    Critical Disk Error Number <n>
  1520.       If this error occurs, your disk drive may have a serious problem.
  1521.       Record the error number and have your disk checked. If no
  1522.       problem can be found, contact Rational Data Systems or your
  1523.       PopTerm/NVT supplier.
  1524.  
  1525.    Disk full
  1526.       The disk indicated is full. You should immediately exit
  1527.       PopTerm/NVT and make additional disk space available.
  1528.  
  1529.    Drive Not Ready
  1530.       If this error occurs while you are running PopTerm/NVT from a
  1531.       floppy drive, this usually indicates that either the drive door
  1532.       is open or the disk was not properly inserted. Reload the disk
  1533.       and repeat the operation. If this error occurs while you are
  1534.       running from a hard disk, this may indicate serious disk drive
  1535.       problems.
  1536.  
  1537.    Error Receiving from Host. Session will be closed.
  1538.       A network error has occurred for the current session. This
  1539.       usually indicates that the NetWare server has gone down or a
  1540.       cable has been disconnected. There will usually be a pause of
  1541.       about 10 seconds before this error occurs. Once you press a key
  1542.       the session will be closed, and you will be switched to another
  1543.       active session.
  1544.  
  1545.    File exists
  1546.       This error should not occur under normal operation and may
  1547.       indicate a disk or program problem.
  1548.  
  1549.    File locked
  1550.       If you are sharing PopTerm/NVT files on a NetWare Server, it is
  1551.       possible that under rare conditions that a file will be locked by
  1552.       another user. If this error occurs, simply repeat whatever
  1553.       operation you were attempting.
  1554.  
  1555.    File not found
  1556.       This message may occur in several situations. The most common
  1557.       situation is if you are attempting to load a session file and
  1558.       enter a file name that does not exist. It will also appear if
  1559.       the program cannot find a prompt or help file. This is usually
  1560.       due to these files being in a different directory from the
  1561.       directory where the PT.EXE file is located.
  1562.  
  1563.    Invalid file argument
  1564.       This error should not occur under normal operation and may
  1565.       indicate a disk or program problem.
  1566.  
  1567.    Invalid security key
  1568.       This message indicates that the security key on your copy of
  1569.       PT.EXE does not properly match the serial number. If the error
  1570.       occurs, you will be unable to run until technical support
  1571.       provides you with a new key.
  1572.  
  1573.    Invalid session file version
  1574.       This message indicates that the session file that is currently
  1575.       being read is incompatible with the current version of
  1576.       PopTerm/NVT. This should only occur when using a new version of
  1577.       PopTerm/NVT. You will need to re-enter the settings in the
  1578.       Control Panel and save the session file under the same name.
  1579.       This will save the file in the new format. This message may
  1580.       occur on starting PopTerm/NVT if the DEFAULT.SES file is
  1581.       incompatible.
  1582.  
  1583.    No IPX Sockets
  1584.       The maximum number of IPX Sockets has been reached. To increase
  1585.       the number available, modify or create a new file called NET.CFG.
  1586.       This is the file which is used to configure IPX. Place the file
  1587.       in the directory you will be in when IPX is started. If you
  1588.       start IPX from your AUTOEXEC.BAT file, place NET.CFG in the root
  1589.       directory. Add or modify the line,
  1590.  
  1591.            IPX SOCKETS = <number>
  1592.  
  1593.       where <number> is the current value. The value should be at
  1594.       least 20. If the value was already 10 or more, then increase it
  1595.       by 10. This should provide you with enough IPX Sockets. You
  1596.       will need to reboot and reload IPX for the new value to take
  1597.       effect.
  1598.  
  1599.    No remote login ports available.
  1600.       This error message occurs when all of the available NVT
  1601.       connections on the server are currently in use. Unlike other
  1602.       error messages, this message is sent as text from the server, so
  1603.       it will appear in the main screen in place of the login prompt.
  1604.       No further activity can occur within this session until another
  1605.       user frees up a connection. If this error occurs often, you may
  1606.       want to have the number of connections that are currently
  1607.       configured on the server increased. Contact your systems
  1608.       administrator for assistance.
  1609.  
  1610.    Printer Not Ready
  1611.       This indicates that the printer is off, off-line or out of paper.
  1612.       Correct the problem and retry the last operation.
  1613.  
  1614.    Too many files open
  1615.       This error may occur if you are running other applications along
  1616.       with PopTerm/NVT. The solution is to see that in your CONFIG.SYS
  1617.       file that FILES= is set to at least 30. This may need to be
  1618.       greater than 30 for some applications.
  1619.  
  1620.    Too many PopTerm/NVT users connected.
  1621.       PopTerm/NVT is sold in different versions based on the number of
  1622.       users that can use the program at a time. This error message
  1623.       will occur if you try to start the program when the maximum
  1624.       number of users is currently using PopTerm/NVT. You will have to
  1625.       wait until another user exits PopTerm/NVT before you will be able
  1626.       to restart the program. If this error occurs often, you may want
  1627.       to upgrade PopTerm/NVT to a higher user count. Contact your
  1628.       systems administrator for assistance.
  1629.  
  1630.    Unable to Connect to Server
  1631.       While in the connection manager, if there is a problem with the
  1632.       server that you have selected, a connection may fail. Contact
  1633.       your NetWare systems administrator if this occurs. This error
  1634.       will occur if you are attempting to connect by using Alt-L to
  1635.       load a session file, and if the name in the file is not a valid
  1636.       server name or if that server is not running.
  1637.  
  1638.    Write-Protect Disk
  1639.       This error will only occur if you are running PopTerm/NVT on a
  1640.       floppy drive with a write-protected disk. Simply remove the
  1641.       write-protection tab and repeat the operation.
  1642.  
  1643.  
  1644.  
  1645.  
  1646.                             PopTerm/NVT for Windows
  1647.                             
  1648.                             
  1649.       PopTerm/NVT is a family of multi-session LAN-based terminal
  1650.       emulation software packages designed specifically for use with
  1651.       NetWare for Unix. PopTerm/NVT for Windows emulates VT-52, VT-102
  1652.       and VT-220 terminals on IBM PC, XT, AT, PS/2 and compatible
  1653.       computers under Microsoft Windows 3.x.
  1654.  
  1655.  
  1656. Features
  1657. ========
  1658.  
  1659.       PopTerm/NVT for Windows includes the following features:
  1660.  
  1661.          * VT-xxx Emulation
  1662.  
  1663.             PopTerm/NVT for Windows emulates the important features of
  1664.             Digital Equipment's popular VT-52, VT-102 and VT-220
  1665.             terminals.
  1666.  
  1667.          * Integrated NVT
  1668.  
  1669.             NetWare Virtual Terminal (NVT) is the LAN-based protocol 
  1670.             for terminal emulation in conjunction with NetWare for Unix.
  1671.             While many emulators are NVT compatible, PopTerm/NVT is the
  1672.             first emulator to actually include enhanced functionality of
  1673.             Novell's NVT.EXE within the emulator itself.
  1674.  
  1675.          * Multiple Sessions
  1676.  
  1677.             Multiple instances of PopTerm/NVT, each consisting of a single
  1678.             session, may be run at each workstation. These sessions may be
  1679.             on a single or separate NetWare for Unix servers. PopTerm/NVT
  1680.             accomplishes this without the need for additional software on
  1681.             the NetWare for Unix server.
  1682.  
  1683.          * Internationalization
  1684.  
  1685.             PopTerm/NVT is a truly international product. In addition to 
  1686.             support for most character sets, a pull-down menu option 
  1687.             instantly switches PopTerm/NVT's prompts and messages between
  1688.             languages.
  1689.  
  1690.          * Remappable Keyboard
  1691.  
  1692.             To support applications which expect a variety of keyboard 
  1693.             layouts as well as the unique requirements of many non-U.S.
  1694.             keyboards, PopTerm/NVT supports redefining or remapping of
  1695.             most of the keyboard character codes.
  1696.  
  1697.          * Network Ready
  1698.  
  1699.             PopTerm/NVT's simple installation and management procedures 
  1700.             are designed for the multi-user environment. Individual 
  1701.             session files retain host-specific data and each user's
  1702.             preferences for colors, languages and other emulation
  1703.             attributes.
  1704.  
  1705.          * Keyboard Macros
  1706.  
  1707.             PopTerm NVT supports user-programmable function keys or 
  1708.             macros.
  1709.  
  1710.          * Restrictions
  1711.  
  1712.             While PopTerm supports all of the most commonly used
  1713.             functions of the DEC VTxxx terminals, it does not support
  1714.             downloadable fonts or the DEC Technical Character Set.
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.                                  Installation
  1721.  
  1722.  
  1723. Installation Checklist
  1724. ======================
  1725.  
  1726.       Before installing PopTerm/NVT for Windows, check the following
  1727.       items:
  1728.  
  1729.  
  1730. READ.ME
  1731. =======
  1732.       Print and read the file READ.ME. It contains information and
  1733.       documentation which supersedes this User's Guide. It is a simple
  1734.       ASCII file which you can view with an editor such as NOTEPAD.EXE.
  1735.  
  1736.  
  1737. IPX
  1738. ===
  1739.       If you are using the NetWare ODI drivers, check your version of
  1740.       IPXODI.COM by changing to the directory where your IPXODI.COM
  1741.       driver is located and entering the following MS-DOS command:
  1742.  
  1743.            IPXODI ?
  1744.  
  1745.       The IPXODI version number will be displayed. You must have an
  1746.       IPXODI version 1.10 or later.
  1747.  
  1748.       If you are using a non-ODI IPX.COM, check your version of IPX.COM
  1749.       by changing to the directory where your IPX.COM driver is located
  1750.       and entering the following MS-DOS command:
  1751.  
  1752.            IPX -I
  1753.  
  1754.       The IPX version number will be displayed. If your IPX is older
  1755.       than 3.02A, you must build a new IPX.COM. Refer to your NetWare
  1756.       documentation for details on building a new IPX.COM
  1757.  
  1758.  
  1759. Load NetWare Drivers
  1760. ====================
  1761.  
  1762.       The NetWare IPX driver (IPX.COM) and Shell (NETX.EXE) must be
  1763.       loaded before you start Windows. There are many versions of
  1764.       these files, some specific to versions of MS-DOS, some which
  1765.       can be loaded into high memory, etc. Refer to your NetWare
  1766.       documentation for complete details on the NetWare IPX driver and
  1767.       Shell.
  1768.  
  1769.  
  1770. Standard Mode Support
  1771. =====================
  1772.  
  1773.       If you intend to run Windows in Standard Mode, you must load
  1774.       either TBMI.COM or TBMI2.COM prior to running Windows. These
  1775.       files may be found on the PopTerm/NVT release diskette and should
  1776.       be copied to an appropriate directory on your hard disk or file
  1777.       server.
  1778.  
  1779.       If you are using a release of MS-DOS prior to 5.0, and you are
  1780.       running Windows 3.0 or 3.0a, use TBMI.COM. Otherwise use
  1781.       TBMI2.COM.
  1782.  
  1783.  
  1784. NetWare Under Windows
  1785. =====================
  1786.  
  1787.       Start Windows and run the Windows Setup utility which is usually
  1788.       found in the Main program group. Check to see that the NetWork
  1789.       item is set to NetWare. If it is not, refer to your Windows
  1790.       documentation for instructions regarding the installation of
  1791.       NetWare under Windows.
  1792.  
  1793.  
  1794. Loading TBMI* from a Batch File
  1795. ===============================
  1796.  
  1797.       If you are required to run TBMI2.COM or TBMI.COM, you will find
  1798.       it helpful to create a batch file which loads it, starts Windows,
  1799.       and then unloads it when you exit Windows. Here is what the
  1800.       batch file should look like:
  1801.  
  1802.            C:\PTWIN\TBMI2
  1803.            C:\WINDOWS\WIN
  1804.            C:\PTWIN\TBMI2 /U
  1805.  
  1806.       Change the paths as required if your files are located elsewhere.
  1807.       If you already have a batch file to start Windows, add the lines
  1808.       containing TBMI2 to it.
  1809.  
  1810.       If you need to use TBMI.COM instead of TBMI2.COM, edit the batch
  1811.       file to remove the "2" from each line.
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.                                    SETUP.EXE
  1818.  
  1819.  
  1820. Start Windows
  1821. =============
  1822.  
  1823.       SETUP.EXE is a Windows-based program. It cannot be run from the
  1824.       MS-DOS command line.
  1825.  
  1826.  
  1827. Run SETUP.EXE
  1828. =============
  1829.  
  1830.       Insert the release diskette into a diskette drive. Select the
  1831.       Run option from the Windows Program Manager File menu. Enter
  1832.       your disk drive's identifier followed by "SETUP":
  1833.  
  1834.            a:setup
  1835.  
  1836.       The Setup program will prompt you for the drive and directory
  1837.       into which you want to install PopTerm. After you have entered
  1838.       the directory, select Continue and the installation will proceed.
  1839.  
  1840.  
  1841. Starting PopTerm/NVT
  1842. ====================
  1843.  
  1844.       Once the installation is complete, you will see the PopTerm/NVT
  1845.       icon. Double-click on the icon and the program will start.
  1846.       Select Connect from the Server menu, select a server, and you
  1847.       should be presented with the login prompt from your Unix host.
  1848.  
  1849.  
  1850. If No Servers Appear
  1851. ====================
  1852.  
  1853.       If no servers are shown in the list, it is usually attributable
  1854.       to one of the following causes.
  1855.  
  1856.       First, NVT may not be running or may not be configured properly
  1857.       on your NetWare for Unix server. See your NetWare for Unix
  1858.       documentation for instructions on how to enable NVT using the
  1859.       sconsole utility.
  1860.  
  1861.       Second, the IPX driver on your PC may not be configured properly.
  1862.       Can you connect to your NetWare for Unix file server as an
  1863.       ordinary NetWare client (i.e., for file and print service)? If
  1864.       not, then refer to your NetWare documentation for instructions on
  1865.       configuring your IPX and LAN adaptor.
  1866.  
  1867.       If neither of these suggestions solves the problem, use NVT.EXE
  1868.       as a diagnostic tool as described below.
  1869.  
  1870.  
  1871. Testing with NVT.EXE
  1872. ====================
  1873.  
  1874.       Your NetWare for Unix software includes an MS-DOS program called
  1875.       NVT.EXE which is used by other terminal emulators to communicate
  1876.       with NetWare for Unix's NVT. The functionality of NVT.EXE is
  1877.       contained within PopTerm/NVT, so NVT.EXE should not be used with
  1878.       PopTerm/NVT. You can, however, use NVT.EXE to test the ability
  1879.       to make a connection to the server.
  1880.  
  1881.       First exit Windows and return to the MS-DOS prompt. Do not
  1882.       attempt to run NVT.EXE from within a Windows DOS Box. Locate the
  1883.       NVT.EXE program which was supplied with your NetWare for Unix
  1884.       software. Load NVT.EXE from the MS-DOS prompt by typing:
  1885.  
  1886.            NVT
  1887.  
  1888.       Press Alt-T to bring up the list of available NVT servers. The
  1889.       list you see using NVT.EXE should be the same as that displayed
  1890.       using PopTerm/NVT.
  1891.  
  1892.       To unload NVT.EXE, press ESCape to return to the MS-DOS command
  1893.       line and enter the following command:
  1894.  
  1895.            NVT -y
  1896.  
  1897.       If servers are displayed using NVT.EXE but not with PopTerm/NVT,
  1898.       contact Rational Data Systems or your supplier for assistance.
  1899.       If no servers are displayed using either NVT.EXE or PopTerm/NVT,
  1900.       the problem is not within PopTerm/NVT.
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.                                PopTerm/NVT Files
  1907.  
  1908.  
  1909.    PopTerm/NVT for Windows includes the following files:
  1910.  
  1911.  
  1912. PopTerm Directory
  1913. =================
  1914.  
  1915.    POPTERM.EXE      The PopTerm/NVT for Windows Program
  1916.    POPHELP.HLP      The Help file
  1917.    PTW-TEXT.*       Menu and dialog box text for the supported languages
  1918.    KEYBOARD.MAP     The standard keyboard map file
  1919.    KEYBOARD.SRC     The source file for KEYBOARD.MAP
  1920.    KEYCOMP.EXE      The keyboard map file compiler
  1921.    KEYTEST.EXE      Keyboard scan code test utility
  1922.  
  1923.  
  1924. SESSIONS Directory
  1925. ==================
  1926.  
  1927.    DEFAULT.SES      The default session file. Other session files you 
  1928.                     create will also be placed here.
  1929.  
  1930.                    
  1931. WINDOWS Directory
  1932. =================
  1933.  
  1934.    POPTERM.INI      This is where various PopTerm/NVT parameters are
  1935.                     stored.
  1936.  
  1937.  
  1938. WINDOWS\SYSTEM Directory
  1939. ========================
  1940.  
  1941.       NWCORE.DLL    These are the Dynamic Link Libraries required to
  1942.       NWBIND.DLL    support PopTerm/NVT for Windows. They are supplied 
  1943.       NWMISC.DLL    by Novell. The .DLL files are also supplied with 
  1944.       NWIPXSPX.DLL  other programs such as Workstation for Windows. 
  1945.       NETWARE.DRV   Programs may only be compatible with specific 
  1946.                     versions of these programs.
  1947.  
  1948.       WUNLOCK.EXE   If you desire to expand your license to support a
  1949.                     larger number of simultaneous users of PopTerm/NVT 
  1950.                     for Windows, a Rational Data Systems technician or 
  1951.                     your authorized distributor can give you instructions
  1952.                     via telephone or FAX to re-configure your serialized
  1953.                     copy of PopTerm/NVT for Windows using this utility.
  1954.  
  1955.       RELEASE.TXT   This ASCII text file contains information which
  1956.                     is more recent than that contained in this User's Guide.
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.                        Installation on a NetWare Server
  1963.  
  1964.  
  1965. Introduction
  1966. ============
  1967.  
  1968.       This section discusses various issues related to installation of
  1969.       the PopTerm/NVT files on a NetWare server instead of installation
  1970.       on individual workstations.
  1971.  
  1972.  
  1973. Security and Sharing
  1974. ====================
  1975.  
  1976.       The location (and therefore privacy) of session files is
  1977.       controlled by settings in the POPTERM.INI file. If Windows has
  1978.       been installed separately for each user (i.e., in different
  1979.       directories on the server), you have a choice as to whether or
  1980.       not users will share session files. If all users execute Windows
  1981.       from a single directory, they will share a session file
  1982.       directory and the session files it contains.
  1983.  
  1984.       The location of the directory to be used for each user's session
  1985.       files is controlled by the following line within POPTERM.INI.
  1986.       Therefore, if multiple users share a single POPTERM.INI file,
  1987.       they will also share all session files.
  1988.  
  1989.       The syntax within POPTERM.INI for defining the session file 
  1990.       directory is as follows:
  1991.  
  1992.            [popterm]
  1993.            Default Directory=C:\PTWIN\
  1994.            Default Session Directory=C:\PTWIN\SESSIONS\ 
  1995.            x=4
  1996.            y=4
  1997.            w=652
  1998.            h=383
  1999.            Windows=3
  2000.            Max=0
  2001.  
  2002.       You may edit this file using any standard ASCII text file editor
  2003.       such as the Windows Notepad. Change the pathname following the
  2004.       equal sign to reflect the location of the session file directory
  2005.       for this (or all) users. 
  2006.  
  2007.  
  2008.  
  2009.  
  2010.                                    Operation
  2011.  
  2012.  
  2013.       In addition to the main area in which terminal emulation is
  2014.       displayed, the PopTerm/NVT screen has three other
  2015.       sections:
  2016.  
  2017. Tabs
  2018. ====
  2019.  
  2020.       The tab ruler shows the current setting of horizontal tab stops.
  2021.       It can be displayed or hidden by the Terminal/Show Tabs menu
  2022.       option.
  2023.  
  2024.  
  2025. Control Panel
  2026. =============
  2027.  
  2028.       The control panel displays the current column and row position of
  2029.       the cursor; and the current state of the four light-emitting
  2030.       diodes (LEDs) on the VT-102 keyboard. The Logging field will
  2031.       display "Off", "Printer", "File" or "Both" to indicate the
  2032.       current file logging mode.
  2033.  
  2034. Menus
  2035. =====
  2036.  
  2037.       The pages that follow describe each of the PopTerm/NVT menu
  2038.       options in detail.
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.                                    File Menu
  2045.  
  2046.  
  2047.    Open
  2048.       Select Open to open an existing Session File. All of the
  2049.       settings that you previously saved in the Session File will be
  2050.       loaded and will become the settings for your current session, or
  2051.       for the next session if you are not connected. If you are not
  2052.       currently connected to a server when you select OK, the program
  2053.       will attempt to connect you to the server name that is in the
  2054.       Session File.
  2055.  
  2056.  
  2057.    Save
  2058.       Select Save to save all of your current settings to the current
  2059.       Session File. If you have not previously loaded a Session File,
  2060.       a dialog box will appear which will let you enter the name of the
  2061.       Session File to be saved.
  2062.  
  2063.    Save As
  2064.       This will save your current settings to a new Session File. You
  2065.       may select the directory and enter the Session File name in the
  2066.       dialog box. You can also enter a Server Name to be saved in the
  2067.       Session File.
  2068.  
  2069.  
  2070.    Printer Setup
  2071.       This option allows you to change any of the print options for
  2072.       your printers. If you have more than one printer, a list of
  2073.       printers will first appear from which you can select a printer.
  2074.       You will then be presented with a dialog box with the options for
  2075.       that printer. The options available will be different for
  2076.       different printers.
  2077.  
  2078.       Once you have selected the printer and set the options, then all
  2079.       subsequent Print Screens or Printer Echos will use the selected
  2080.       printer and options. Any changes made here will only effect
  2081.       printing in PopTerm/NVT and not in other applications.
  2082.  
  2083.  
  2084.    Print Screen
  2085.       Print Screen prints a copy of the current PopTerm/NVT window. It
  2086.       will print 24 rows by either 80 or 132 columns. Print Screen
  2087.       sends text to the printer, not a graphic image of the screen.
  2088.  
  2089.  
  2090.    Exit
  2091.       Exit will close the PopTerm/NVT window. If you are currently
  2092.       connected, a dialog box will appear to confirm that you want to
  2093.       disconnect from the current session.
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.                                    Edit Menu
  2100.  
  2101.  
  2102.    Copy
  2103.       The Copy command will copy the currently selected text into the
  2104.       Windows Clipboard. Text can be selected by clicking with the
  2105.       mouse at the beginning of the selection and dragging the mouse to
  2106.       the end of the selection, or by using the Select All command.
  2107.  
  2108.  
  2109.    Paste
  2110.       The Paste command will take whatever currently resides on the
  2111.       Windows Clipboard and send it to the host. Paste will only send
  2112.       text to the host. Any graphic images on the Clipboard will be
  2113.       ignored.
  2114.       
  2115.       For further information on the Windows Clipboard, refer to your
  2116.       Windows documentation.
  2117.  
  2118.  
  2119.    Select All
  2120.       Select All will cause all of the text in the entire PopTerm
  2121.       window to become selected. This may include areas that are not
  2122.       currently visible in the window.
  2123.  
  2124.  
  2125.    Erase Screen
  2126.       Erase Screen erases all the data from the display.
  2127.  
  2128.       -----------------------------------------------------------------
  2129.        NOTE:  Erase Screen is a local operation and does not
  2130.               communicate with the host computer system.
  2131.       -----------------------------------------------------------------
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.                                  Terminal Menu
  2138.  
  2139.  
  2140.    Macros
  2141.       The Macros dialog box allows you to enter messages of up to 100
  2142.       characters each that will be sent to the host whenever a macro
  2143.       function key is pressed. The default macro function keys are
  2144.       Ctrl-Shift-F1 through Ctrl-Shift-F6.
  2145.  
  2146.       You can enter a control characters in a Macro by preceding the
  2147.       control character with the "^" (Shift-6) symbol. For example, to
  2148.       send control-C to the host, enter ^C in the Macro field.
  2149.       If you want to send ESCape sequences to the host, you can enter
  2150.       "^[" (caret followed by a left square bracket) to place an ESCape
  2151.       character in a macro.
  2152.  
  2153.  
  2154.    Settings
  2155.       The Terminal Settings option displays a window allowing you to
  2156.       examine and change the following emulation modes:
  2157.  
  2158.          * Terminal Type
  2159.    
  2160.             Enter the type of terminal emulation desired, either DEC
  2161.             VT-52, DEC VT-102, DEC VT-220 in 7-bit mode or VT-220 in 
  2162.             8-bit mode. The setting here must match the TERM variable 
  2163.             on the UNIX server.
  2164.  
  2165.          * Columns
  2166.  
  2167.             Indicate whether to display in 80 column or 132 column
  2168.             mode.
  2169.  
  2170.          * Cursor Shape
  2171.  
  2172.             Select either a Block or Underline cursor.
  2173.  
  2174.          * Cursor Rate
  2175.  
  2176.             Enter a Cursor Blink Rate. 1=Slowest. 5=Fastest.
  2177.  
  2178.          * Auto Wrap
  2179.  
  2180.             Check this box if you want characters to wrap around to
  2181.             the next line whenever a character is displayed in the last
  2182.             column.
  2183.  
  2184.          * Auto Line Feed
  2185.  
  2186.             Check this box if you want each carriage return that is
  2187.             sent to the host to be followed by a line feed.
  2188.  
  2189.          * Key Click
  2190.  
  2191.             Check this box if you want an audible click with each
  2192.             keystroke.
  2193.  
  2194.          * Margin Bell
  2195.  
  2196.             Check this box if you want a beep whenever you are 8
  2197.             characters from the end of a line.
  2198.  
  2199.  
  2200.          * Reverse Video
  2201.  
  2202.             Check this box if you want the foreground and background
  2203.             colors to be reversed.
  2204.  
  2205.          * ANSI Colors
  2206.  
  2207.             If your host computer will send ANSI color commands, then
  2208.             selecting this option will enable PopTerm/NVT for Windows to
  2209.             display the ANSI colors. The colors displayed will override
  2210.             the normal foreground/background color selections.
  2211.  
  2212.          * Answer Back
  2213.  
  2214.             Enter a message to be returned to the host whenever a
  2215.             Read Status request is sent from the host.
  2216.  
  2217.          * Font
  2218.  
  2219.             Select a font and point size from the list. 
  2220.  
  2221.  
  2222.    Language
  2223.       The Language option displays a window allowing you to examine and
  2224.       change various language-specific options.
  2225.  
  2226.          * Language
  2227.  
  2228.             Select the language in which all menus and dialog boxes
  2229.             will be displayed.
  2230.  
  2231.          * Character Set
  2232.  
  2233.             Select the appropriate National Replacement Character Set.
  2234.  
  2235.       
  2236.    Colors
  2237.       Select the Foreground and Background colors. When you select a
  2238.       color, the Sample Text at the top of the dialog box will show you
  2239.       how the current color combination will appear.
  2240.  
  2241.       The colors you select may be changed by ANSI ESCape sequences
  2242.       transmitted by your host applications if ANSI is selected in the
  2243.       Settings dialog box.
  2244.  
  2245.       -----------------------------------------------------------------
  2246.        NOTE:  The first color show in the Background Color list is the
  2247.               color selected in the Windows Control Panel as your
  2248.               standard Windows background color.
  2249.       -----------------------------------------------------------------
  2250.  
  2251.  
  2252.    Printer Echo
  2253.       Whenever the Printer Echo menu option is checked, all text that
  2254.       is displayed in the PopTerm window will be echoed to the
  2255.       currently selected printer. To turn off Printer Echo, select the
  2256.       menu item again.
  2257.  
  2258.  
  2259.    File Echo
  2260.       If you select File Echo, then a dialog box will appear in which
  2261.       you can enter a file name. Once you enter the name and press OK,
  2262.       all data that is sent from the host and displayed in the window
  2263.       will also be written to the file. To stop writing to the file,
  2264.       select the menu item again.
  2265.  
  2266.  
  2267.    Show Tabs
  2268.       Whenever the Show Tabs menu option is checked, the Tab Bar will
  2269.       appear at the top of the PopTerm window. You can change the tab
  2270.       settings at any time by clicking on the Tab Bar or by selecting
  2271.       Clear Tabs or Default Tabs from the menu. To remove the Tab Bar,
  2272.       click on the Show Tabs option again.
  2273.  
  2274.  
  2275.    Show Status
  2276.       Whenever the Show Status menu option is checked, the Status Bar
  2277.       will appear at the bottom of the screen. The Status Bar
  2278.       indicates the current row and column of the cursor, the LED
  2279.       lights for VT-102 and VT-220 terminals, and whether File Echo
  2280.       and/or Printer Echo are currently on. To remove the Status Bar,
  2281.       click on the Show Status menu option again.
  2282.  
  2283.  
  2284.    Clear Tabs
  2285.       When the Tab Bar is currently showing, clicking on Clear Tabs
  2286.       will remove all Tab settings.
  2287.  
  2288.  
  2289.    Default Tabs
  2290.       When the Tab Bar is currently showing, clicking on Default Tabs
  2291.       will set a tab at the 9th column, and at every 8th column
  2292.       thereafter.
  2293.  
  2294.  
  2295.    Send File
  2296.       The Send File option allows you to send a file to the host. A
  2297.       dialog box will appear asking for the name of the file to send.
  2298.       The file will be sent to the host as if you had typed the
  2299.       information from the keyboard. It is recommended that the Send
  2300.       File option only be used for sending text files.
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.                                   Server Menu
  2307.  
  2308.  
  2309.       When you choose the Server menu, only one of the items, Connect
  2310.       or Disconnect, can be selected.
  2311.  
  2312.       If you have a currently active session, then the Disconnect item
  2313.       can be selected. If there is no active session, then the Connect
  2314.       item can be selected.
  2315.  
  2316.  
  2317.    Connect
  2318.       The Connect option first presents a list of the currently
  2319.       available servers.
  2320.  
  2321.       When you select a server, the program will try to connect you to
  2322.       that server. If it is successful you will be presented with the
  2323.       login prompt from the host.
  2324.  
  2325.       -----------------------------------------------------------------
  2326.        HINT:  You may need to hit the Enter key once or twice before
  2327.               you receive the login prompt.
  2328.       -----------------------------------------------------------------
  2329.  
  2330.       You can also connect to a server using a previously saved session
  2331.       file as described later.
  2332.  
  2333.  
  2334.    Disconnect
  2335.       When you select the Disconnect option, you will first be
  2336.       presented with a dialog box to confirm that you want to
  2337.       disconnect. If you select Yes, your session with the host will
  2338.       be terminated.
  2339.  
  2340.       -----------------------------------------------------------------
  2341.        NOTE:  Exiting PopTerm/NVT while a session is active will
  2342.               perform a Disconnect on that session.
  2343.       -----------------------------------------------------------------
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.                                  Session Files
  2350.  
  2351.  
  2352.       Session Files contain a server name, macros, terminal settings,
  2353.       colors, language, font, character set, and tab settings.
  2354.       Session files are created by selecting Save As from the File
  2355.       Menu. All of the settings for the current session will be saved
  2356.       in the Session File. You can select the directory in which to
  2357.       place the Session File.
  2358.  
  2359.       A different Session File can be loaded for the current session by
  2360.       selecting Open in the File Menu. The settings from that Session
  2361.       File will become the new settings for the current session.
  2362.       PopTerm/NVT is installed with a Default Session File which is
  2363.       called DEFAULT.SES. Whenever PopTerm/NVT is started, if no
  2364.       Session Files are indicated on the command line, the program will
  2365.       load the Default Session File and attempt to establish a
  2366.       connection with the server named in that file. You can change
  2367.       the settings and the server name in the Default Session File by
  2368.       selecting Save As from the File Menu, and saving the session to
  2369.       file name DEFAULT.SES.
  2370.  
  2371.  
  2372. POPTERM.INI
  2373. ===========
  2374.  
  2375.       The Setup program creates a file called POPTERM.INI in your
  2376.       Windows main directory. This file contains a single section
  2377.       which contains entries of the form,
  2378.  
  2379.            [popterm] 
  2380.            Default Directory=<exe_path>
  2381.            Default Session Directory=<session_path>
  2382.            x=4
  2383.            y=4
  2384.            w=652
  2385.            h=383
  2386.            Windows=3
  2387.            Max=0
  2388.  
  2389.       where <exe_path> is the complete path of the directory in which
  2390.       the PopTerm/NVT for Windows files are loaded, and
  2391.       <session_path> is the directory in which session files will be
  2392.       stored. For example,
  2393.  
  2394.            Default Directory=C:\PTWIN\
  2395.            Default Session Directory=C:\PTWIN\SESSIONS\
  2396.  
  2397.       If you would like to store your session files in a different
  2398.       directory, change the Default Session Directory. You should copy
  2399.       DEFAULT.SES to the new directory.
  2400.  
  2401.  
  2402. Search Algorithm
  2403. ================
  2404.  
  2405.       The method by which PopTerm/NVT searches for session files has
  2406.       been carefully designed to support both single-user and LAN
  2407.       environments, recognizing that in a LAN environment there will be
  2408.       times at which users will want to share session files and other
  2409.       times at which they will want to use private session files.
  2410.       If a command line argument was specified via the Program Item
  2411.       Property or via the Run command, PopTerm/NVT uses the following
  2412.       logic:
  2413.  
  2414.          * If a filename extension was specified, it is removed.
  2415.    
  2416.          * The extension ".SES" is appended.
  2417.    
  2418.          * If a drive or path was specified, only that drive or
  2419.          path is searched.
  2420.    
  2421.          * If no drive or path was specified, PopTerm/NVT searches
  2422.          first in the Default Session Directory specified in the
  2423.          POPTERM.INI file (see above), then in the current directory.
  2424.    
  2425.          * If the specified session file is not found, an error
  2426.          dialog box is displayed.
  2427.   
  2428.       If no command line argument is specified
  2429.  
  2430.          * PopTerm/NVT first looks for the file DEFAULT.SES using
  2431.          the Default Session Directory specified in POPTERM.INI, then in
  2432.          the current directory.
  2433.   
  2434.       If DEFAULT.SES is not found, PopTerm/NVT will start using
  2435.       internal default parameters.
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.                            Multiple Session Support
  2442.  
  2443.  
  2444.       You may start as many sessions of PopTerm/NVT for Windows as you
  2445.       like by starting multiple copies of PopTerm/NVT. There are two
  2446.       features of the product which will help you keep track of
  2447.       separate sessions.
  2448.  
  2449.  
  2450. Session Files
  2451. =============
  2452.  
  2453.       For ad-hoc sessions, select the Server/Connect menu option then
  2454.       click on the server to which you want to connect. If you want to
  2455.       connect to that server in the future, create a session file for
  2456.       that server. First set the appropriate options from the Terminal
  2457.       menu, then select the File/Save As option. Use a filename that
  2458.       will remind you of the server or the application to which you are
  2459.       connecting.
  2460.  
  2461.       The next time you want to connect to the same server, place the
  2462.       name of the session file on the command line after the
  2463.       PopTerm/NVT program name. For example, if you save a session
  2464.       file named UNIX4.SES, under the Program Manager select the Run
  2465.       option and enter:
  2466.  
  2467.            POPTERM.EXE UNIX4
  2468.  
  2469.       This will start a PopTerm/NVT session with the same attributes
  2470.       and settings that you had previously saved.
  2471.  
  2472.       You may want to create additional PopTerm/NVT program items using
  2473.       the Program Manager's File/New menu option. Each one can specify
  2474.       running PopTerm with a different session file.
  2475.  
  2476.  
  2477. Icons
  2478. =====
  2479.  
  2480.       When you reduce a PopTerm/NVT session to an icon, the text that
  2481.       appears below the icon is the name of the session file currently
  2482.       in use. You can choose your session file names to help you keep
  2483.       track of multiple sessions.
  2484.  
  2485.       You should also consider setting a different background color for
  2486.       each PopTerm/NVT session. When a session is reduced to an icon,
  2487.       the background color of the icon is the same as the background
  2488.       color of the full-sized PopTerm/NVT screen.
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.                            Fonts and Character Sets
  2495.                            
  2496.                            
  2497.       PopTerm/NVT allows you to change the display font and
  2498.       size via the Terminal/Settings dialog box. Only fixed pitch
  2499.       (monospaced) fonts appear on the list. TrueType fonts may be
  2500.       used in 8, 10, 12, 14, 16, 18, 20, 24, 30, 36 and 48 point. You
  2501.       can use non-TrueType fonts in any point size supported by those
  2502.       fonts.
  2503.  
  2504.  
  2505. Window Size
  2506. ===========
  2507.  
  2508.       If the display window is not large enough to display all the data
  2509.       on the emulated terminal's screen, PopTerm/NVT will display
  2510.       vertical and/or horizontal scroll bars as necessary. To resize
  2511.       the window to display exactly the 24x80 or 24x132 column image,
  2512.       select the Terminal/24x80 (or 132) Window menu operation. If the
  2513.       screen and font sizes permit the full image to be displayed, the
  2514.       scroll bars will disappear.
  2515.  
  2516.       If you reduce the font size, the active display area will be less
  2517.       than that used by PopTerm/NVT. Select the Terminal/24x80 (or
  2518.       132) Window option to re-size the window to the optimum
  2519.       dimensions.
  2520.  
  2521.       PopTerm/NVT saves the current window size in the POPTERM.INI file
  2522.       each time you exit the program. The next time you start
  2523.       PopTerm/NVT, it will start with the previously saved window
  2524.       dimensions.
  2525.  
  2526.  
  2527. Character Sets
  2528. ==============
  2529.  
  2530.       PopTerm/NVT can display the DEC line-drawing set (used to draw
  2531.       boxes and other simple graphics) only when an OEM font is
  2532.       selected. The line-drawing characters are not supported by ANSI
  2533.       fonts. For example, Terminal is an OEM font and includes the
  2534.       line drawing characters, whereas Courier, an ANSI font, does not.
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.                              Function Key Mapping
  2541.  
  2542.  
  2543. Accelerator Keys
  2544. ================
  2545.  
  2546.       PopTerm/NVT for Windows provides a number of Windows Accelerator
  2547.       keys. These keys will perform certain menu functions without
  2548.       having to use the mouse. The keys are,
  2549.  
  2550.            Function              Accelerator Key
  2551.            -------------------------------------
  2552.             Open                   Alt-O
  2553.             Save As                Alt-V
  2554.             Copy                   Ctrl-Insert
  2555.             Paste                  Shift-Insert
  2556.             Exit                   Alt-F4
  2557.             Settings               Alt-P
  2558.             Printer Echo           Alt-N
  2559.             File Echo              Alt-L
  2560.             Show Tabs              Alt-B
  2561.             Show Status            Alt-U
  2562.             Connect                Alt-C
  2563.             Disconnect             Alt-D
  2564.  
  2565.  
  2566. Terminal Keys
  2567. =============
  2568.  
  2569.       The following chart indicates the default mapping of the
  2570.       PopTerm/NVT for Windows keys to the DEC VT-xx terminal keys.
  2571.       Function keys are supported for VT-52, VT-102, and VT-220.
  2572.  
  2573.             VT-xxx Key           PopTerm/NVT Key
  2574.             -----------------------------------------
  2575.              Return                Enter
  2576.              Tab                   Tab
  2577.              Delete                Delete
  2578.              Arrow Keys            Arrow Keys
  2579.              Keypad "-"            Keypad "-"
  2580.              Keypad ","            Keypad "*"
  2581.              Keypad "."            Keypad "."
  2582.              Keypad Enter          Keypad "+"
  2583.              PF1..PF4              F1..F4
  2584.              [PopTerm Macros]      Ctrl-Shift F1..F6
  2585.              Insert                Insert
  2586.              Prev Screen           Page Up
  2587.              Next Screen           Page Down
  2588.              Find                  Ctrl-F1
  2589.              Insert                Ctrl-F2
  2590.              Remove                Ctrl-F3
  2591.              Select                Ctrl-F4
  2592.              F6..F12               F6..F12
  2593.              F11..F20              Shift-F1..F10
  2594.  
  2595.       -----------------------------------------------------------------
  2596.        NOTE:  The VT-xxx F11 and F12 keys may be simulated by either
  2597.               pressing the PC F11 and F12 keys or Shift-F1 and Shift-F2.
  2598.       -----------------------------------------------------------------
  2599.  
  2600.       -----------------------------------------------------------------
  2601.        NOTE:  It is possible to remap many of the above keys.  Refer 
  2602.               to the section in this manual on keyboard remapping for
  2603.               more information.
  2604.       -----------------------------------------------------------------
  2605.  
  2606.  
  2607.  
  2608.                                 Error Messages
  2609.  
  2610.    Could not open socket
  2611.       The maximum number of IPX Sockets has been reached. To increase
  2612.       the number available, modify or create a new file called NET.CFG.
  2613.       This is the file that is used to configure IPX. Place the file
  2614.       in the directory you will be in when IPX is started. If you
  2615.       start IPX from your AUTOEXEC.BAT file, then place NET.CFG in the
  2616.       root directory. Add or modify the line,
  2617.  
  2618.            IPX SOCKETS = <number>
  2619.  
  2620.       where <number> is the current value. This value should be at
  2621.       least 40. This should provide you with enough IPX Sockets. If
  2622.       necessary, increase by 10 sockets at a time. You will need to
  2623.       reboot and reload IPX for the new value to take effect.
  2624.  
  2625.    Connection to Host has failed.
  2626.       A network error has occurred for the current session. This
  2627.       usually indicates that the NVT server has gone down or a cable
  2628.       has been disconnected. There will usually be a pause of about 10
  2629.       seconds before this error occurs. Once you press a key, you will
  2630.       be disconnected from that session. You may then try to
  2631.       re-connect or connect to another server.
  2632.  
  2633.    Invalid Security Key
  2634.       This message indicates that the security key on your copy of
  2635.       POPTERM.EXE does not properly match the serial number. If the
  2636.       error occurs, you will be unable to run until technical support
  2637.       provides you with a new key.
  2638.  
  2639.    Invalid session file version
  2640.       This message indicates that the session file that is currently
  2641.       being read is incompatible with the current version of
  2642.       PopTerm/NVT for Windows. This message may occur on starting
  2643.       PopTerm/NVT if the DEFAULT.SES file is incompatible.
  2644.  
  2645.    IPX Initialization Error #<number>
  2646.       PopTerm/NVT is unable to initialize IPX. This is sometimes due
  2647.       to an incompatibility between the revision of IPX and
  2648.       NWIPXSPX.DLL. Try using the most recent versions of each of your
  2649.       IPX driver and NWIPXSPX.DLL.
  2650.  
  2651.    IPX must be loaded
  2652.       The program IPX.COM or IPXODI.COM must be loaded before you start
  2653.       Windows. This error indicates that PopTerm/NVT for Windows could
  2654.       not find IPX in memory. If this error occurs, no connections
  2655.       will be possible.
  2656.  
  2657.    Keyboard Mapfile not found
  2658.       PopTerm/NVT was unable to locate the keyboard map file.
  2659.  
  2660.    Language file not found
  2661.       PopTerm/NVT for Windows stores some of the text for different
  2662.       languages in files of the form PTW-TEXT.*. If these files are
  2663.       not available to the program, then when you change to a new
  2664.       language this error will occur. Certain prompts will then remain
  2665.       in the previous language. These files should be in the default
  2666.       directory as specified in POPTERM.INI.
  2667.  
  2668.    No remote login ports available
  2669.       This error message occurs when all of the available NVT
  2670.       connections on the server are currently in use. Unlike the other
  2671.       error messages, this message is sent as text from the server, so
  2672.       it will appear in the main screen in place of the login prompt.
  2673.       No further activity can occur on this session until another user
  2674.       frees up a connection. If this error occurs often, you may want
  2675.       to have the number of connections that are currently configured
  2676.       on the server increased. Contact your systems administrator for
  2677.       assistance.
  2678.  
  2679.    No timers available
  2680.       Under Windows, a limited number of timers are available for
  2681.       applications to use. If other applications are using all of the
  2682.       timers when PopTerm/NVT for Windows starts up, then this error
  2683.       will occur, and you will be unable to run the program. You may
  2684.       be able to free up some timers by closing another application.
  2685.  
  2686.    Out of memory
  2687.       There is insufficient memory to run PopTerm/NVT for Windows. Try
  2688.       closing another application to free up some memory.
  2689.  
  2690.    Send error
  2691.       PopTerm/NVT for Windows was unable to send characters to the
  2692.       host. This usually means that the host has stopped accepting
  2693.       characters from the program. Check with your systems
  2694.       administrator.
  2695.  
  2696.    Session file not found
  2697.       The Session File indicated was not found. Change the file name
  2698.       or the directory to load the file. This error may occur on
  2699.       startup if the DEFAULT.SES file cannot be found.
  2700.  
  2701.    Too many PopTerm/NVT users connected
  2702.       PopTerm/NVT is sold in different versions based on the number of
  2703.       users that can use the program at one time. This error message
  2704.       will occur if you try to start the program when the maximum
  2705.       number of users is currently using PopTerm/NVT. You will have to
  2706.       wait until another user exits PopTerm/NVT before you will be able
  2707.       to restart the program. If this error occurs often, you may want
  2708.       to upgrade PopTerm/NVT to a higher user count. Contact your
  2709.       systems administrator for assistance.
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.                                Emulation Issues
  2716.  
  2717.  
  2718. Introduction
  2719. ============
  2720.  
  2721.       This chapter describes in detail how PopTerm/NVT for MS-DOS and
  2722.       Windows emulate various terminal types. The sections of this
  2723.       chapter are:
  2724.  
  2725.          * Your Unix Host
  2726.    
  2727.             This section discusses various issues relating to host
  2728.             applications, environment settings and NVT.
  2729.    
  2730.          * VT-52 ESCape Sequences
  2731.    
  2732.          * VT-102 ESCape Sequences
  2733.    
  2734.          * VT-220 ESCape Sequences
  2735.    
  2736.          * ANSI Color Support
  2737.  
  2738.       PopTerm/NVT supports ANSI colors in both VT-102 and VT-220
  2739.       modes. This section describes that support and how to modify your
  2740.       Unix applications to take advantage of it.
  2741.  
  2742.          * Keyboard Remapping
  2743.  
  2744.             Many of the PopTerm/NVT keyboard assignments may be changed
  2745.             by editing and recompiling the keyboard map as described in
  2746.             this section.
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.                                 Your Unix Host
  2753.  
  2754.  
  2755. Environment Variables
  2756. =====================
  2757.  
  2758.       Some Unix applications require the proper values for certain
  2759.       environment variables on your host system. The manner in which
  2760.       this is done depends upon your host system as well as the Unix
  2761.       shell in use. Some examples of how these environment variables are
  2762.       set are shown below.
  2763.  
  2764.       -----------------------------------------------------------------
  2765.        WARNING!   The examples shown here are only examples. The shell
  2766.                   commands which are right for your system will, very
  2767.                   likely, be different. Refer to the documentation for
  2768.                   your host Unix system and your application(s).
  2769.       -----------------------------------------------------------------
  2770.  
  2771.       For running many Unix applications such as "vi":
  2772.  
  2773.          * using the C Shell:
  2774.    
  2775.             setenv TERM vt220
  2776.    
  2777.          * using the Bourne or Korn Shells:
  2778.    
  2779.             TERM=vt220
  2780.             export TERM
  2781.  
  2782.       Some applications require the setting of additional
  2783.       application-specific variables. For running WordPerfect/Unix, for
  2784.       example, add the following:
  2785.  
  2786.          * using the C Shell:
  2787.  
  2788.             setenv WPTERM vt220
  2789.  
  2790.          * using the Bourne or Korn Shells:
  2791.  
  2792.             WPTERM=vt220
  2793.             export WPTERM
  2794.  
  2795.  
  2796. Configuring NVT Connections on the Server
  2797. =========================================
  2798.  
  2799.       The number of NVT connections that can be made to a single server
  2800.       can be configured by the system administrator for the server.
  2801.       NetWare for Unix provides a program called sconsole that can be run
  2802.       on the server to set the number of NVT connections. See your
  2803.       NetWare for Unix documentation for details.
  2804.  
  2805.       -----------------------------------------------------------------
  2806.        HINT:  Each PopTerm/NVT session requires one connection. If 10
  2807.               users each have 3 sessions currently active, this 
  2808.               requires 30 connections. If users are regularly getting
  2809.               the 'No remote login ports available' error message, then
  2810.               the number of NVT connections on the server should be
  2811.               increased. Some versions of NetWare for Unix will only
  2812.               allow a maximum of 50 NVT connections.
  2813.       -----------------------------------------------------------------
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.                                 VT-52 Emulation
  2820.  
  2821. Keyboard Mapping
  2822. ================
  2823.  
  2824.       In VT-52 mode, PopTerm/NVT's keyboard mapping is permanent. The
  2825.       function keys are mapped as follows:
  2826.  
  2827.             Keyboard          DEC VT-52 Key
  2828.             ---------------------------------
  2829.              F1                   PF1
  2830.              F2                   PF2
  2831.              F3                   PF3
  2832.              F4                   PF4
  2833.              F5-F10       (used for PopTerm/NVT Macro keys)
  2834.  
  2835.  
  2836. Display Function Codes
  2837. ======================
  2838.  
  2839.       PopTerm/NVT supports the following display ESCape sequences in
  2840.       VT-52 mode:
  2841.  
  2842.          Sequence           Function
  2843.          ---------------------------------------------------
  2844.           ESC <             Enter ANSI Mode
  2845.           ESC A             Cursor Up
  2846.           ESC B             Cursor Down
  2847.           ESC C             Cursor Right
  2848.           ESC D             Cursor Left
  2849.           ESC H             Cursor Home
  2850.           ESC Y<r><c>       Cursor Position (<r>ow,<c>olumn)
  2851.           ESC K             Erase to end of line
  2852.           ESC J             Erase to end of screen
  2853.           ESC Z             Request Device Reply
  2854.           ESC =             Keypad Application Mode
  2855.           ESC >             Keypad Numeric Mode
  2856.           ESC I             Reverse Line Feed
  2857.  
  2858.  
  2859.  
  2860.  
  2861.                                VT-102 Emulation
  2862.  
  2863.  
  2864.       PopTerm/NVT supports the following display ESCape sequences in
  2865.       VT-102 and TV-102/AC modes:
  2866.  
  2867.            Sequence            Function
  2868.            ---------------------------------------------------
  2869.             ESC #3             Dbl-top
  2870.             ESC #4             Dbl-Bottom
  2871.             ESC #5             Single
  2872.             ESC #6             Dbl-Wide
  2873.             
  2874.             ESC [<n>m          Attributes (<n>=0-7)
  2875.             ESC [<n>m          Attributes (<n>=22-27)
  2876.             ESC [<n>m          ANSI Colors (<n>=30-37, 40-47)
  2877.       
  2878.             ESC 7              Save Cursor
  2879.             ESC 8              Restore Cursor
  2880.       
  2881.             ESC D              Cursor Down
  2882.             ESC E              Cursor to Start of Next Line
  2883.             ESC M              Cursor Up
  2884.       
  2885.             ESC [<n>A          Cursor Up <n>
  2886.             ESC [<n>B          Cursor Down <n>
  2887.             ESC [<n>C          Cursor Right <n>
  2888.             ESC [<n>D          Cursor Left <n>
  2889.       
  2890.             ESC [<r;c>H        Cursor at <r,c>
  2891.             ESC [<r;c>f        Cursor at <r,c>
  2892.             ESC [<t;b>r        Set Scrolling Region <t>op;<b>ottom
  2893.  
  2894.  
  2895.  
  2896.       Within the following group, replace "h" with "l" to achieve the
  2897.       opposite result:
  2898.  
  2899.             ESC [20h           Auto Linefeed Off/On
  2900.             ESC [?1h           Application/Cursor Mode
  2901.             ESC [?2h           VT-52 mode
  2902.             ESC [?3h           132/80 Column
  2903.             ESC [?4h           Smooth/Jump scrolling
  2904.             ESC [?5h           Reverse/Normal Screen
  2905.             ESC [?6h           Relative/Abs. Origin
  2906.             ESC [?7h           Char. Wrap On/Off
  2907.             ESC =              Application Keypad Mode
  2908.       
  2909.             ESC >              Numeric Keypad Mode
  2910.             ESC [i             Print Screen
  2911.             ESC [?1i           Print Cursor Line
  2912.             ESC [5i            Print to Printer Only
  2913.             ESC [4i            Print to Screen Only
  2914.             ESC [?5i           Print to Printer and Screen
  2915.             ESC [?4i           Print to Screen Only
  2916.             ESC [<n>M          Delete <n> lines
  2917.             ESC [<n>P          Delete <n> chars
  2918.             ESC [<n>L          Insert <n> lines
  2919.             ESC [<n>@          Insert <n> chars
  2920.             ESC [<n>X          Erase <n> chars
  2921.             ESC [K             Erase to end-of-line
  2922.             ESC [1K            Erase from start of line
  2923.             ESC [2K            Erase line
  2924.             ESC [J             Erase to end-of-screen
  2925.             ESC [1J            Erase from start-of-screen
  2926.             ESC [2J            Erase screen
  2927.             ESC H              Set Tab at Column
  2928.             ESC [g             Clear Tab
  2929.             ESC [3g            Clear all tabs
  2930.             ESC [0q            All Leds off
  2931.             ESC [1q            Set LED 1
  2932.             ESC [2q            Set LED 2
  2933.             ESC [3q            Set LED 3
  2934.             ESC [4q            Set LED 4
  2935.             ESC [c             Request device reply
  2936.             ESC [Z             Request device reply
  2937.             ESC [5n            Device Status request
  2938.             ESC [6n            Cursor Position request
  2939.             ESC #8             Screen Alignment Pattern
  2940.             SI                 Map G0 into GL
  2941.             SO                 Map G1 into GL
  2942.  
  2943.  
  2944.       In the following sequences, <c> refers to a single character
  2945.       selected from the Character Sets which follows:
  2946.  
  2947.             ESC (<c>           G0 is c
  2948.             ESC )<c>           G1 is c
  2949.  
  2950.       
  2951. Character Sets
  2952. ==============
  2953.  
  2954.       The following codes may be used to replace <c> in the above
  2955.       character set selection commands:
  2956.  
  2957.             B                 ASCII
  2958.             0                 Special Graphics (Line)
  2959.             A                 British
  2960.             4                 Dutch
  2961.             5 or C            Finnish
  2962.             R                 French
  2963.             9 or Q            French Canada
  2964.             K                 German
  2965.             Y                 Italian
  2966.             ' or E or 6       Norwegian/Dutch
  2967.             Z                 Spanish
  2968.             7 or H            Swedish
  2969.             =                 Swiss
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.                                VT-220 Emulation
  2976.  
  2977.  
  2978. Special Codes
  2979. =============
  2980.  
  2981.       The following are ASCII codes with values greater than 127
  2982.       (decimal) which, therefore, operate only while the emulator is in
  2983.       8-bit mode.
  2984.  
  2985.            Code                Function
  2986.            ----------------------------------------------
  2987.             IND                Index
  2988.             NEL                Next Line
  2989.             HTS                Hor. Tab Set
  2990.             RI                 Reverse Index
  2991.             SS2                Single-Shift G2
  2992.             SS3                Single-Shift G3
  2993.             DCS                Device-Control String
  2994.             CSI                Control Sequence Intro
  2995.             ST                 String Terminator
  2996.  
  2997.       
  2998. ESCape Sequences
  2999. ================
  3000.  
  3001.       PopTerm/NVT supports the following display ESCape sequences in
  3002.       addition to those specified for VT-102 emulation while in VT-220
  3003.       mode:
  3004.  
  3005.            Code                Function
  3006.            --------------------------------------------
  3007.             ESC P              Same as DCS
  3008.             ESC \              Same as ST
  3009.             ESC <sp>F          Select 7-bit Commands
  3010.             ESC <sp>G          Select 8-bit Commands
  3011.             CSI <n>"q          Select erasable
  3012.             ESC 7              Save Cursor
  3013.             ESC 8              Restore Cursor
  3014.  
  3015.  
  3016.       Within the following group, replace "h" with "l" to perform the
  3017.       alternative function:
  3018.  
  3019.             CSI 2h             Lock/Unlock Keyboard
  3020.             CSI 4h             Insert/Replace Mode
  3021.             CSI 12h            Local Echo On/Off
  3022.             CSI ?18h           Print FF after PrSc
  3023.             CSI ?19h           PrSc is Full Screen or Scrolling Region
  3024.             CSI ?25h           Hide/Display cursor
  3025.             CSI 61"p           Set VT-100 mode
  3026.             CSI 62"p           Set VT-220 8-bit
  3027.             CSI 62;0"p         Set VT-220 8-bit
  3028.             CSI 62;2"p         Set VT-220 8-bit
  3029.             CSI 62;1"p         Set VT-220 7-bit
  3030.             CSI <n>M           Delete <n> lines
  3031.             CSI <n>P           Delete <n> chars
  3032.             CSI <n>L           Insert <n> lines
  3033.             CSI <n>@           Insert <n> chars
  3034.             CSI <n>X           Erase <n> chars on line
  3035.             CSI ?0K            Erase EOL erasable
  3036.             CSI ?1K            Erase SOL erasable
  3037.             CSI ?2K            Erase Line erasable
  3038.             CSI ?0J            Erase EOS erasable
  3039.             CSI ?1J            Erase SOS erasable
  3040.             CSI ?2J            Erase screen erasable
  3041.             CSI c              Device attribute request
  3042.             ESC Z              Device attribute request
  3043.             CSI >c             Secondary device attribute
  3044.             CSI ?15n           Printer status request
  3045.             CSI ?25n           User-Defined Keys Locked
  3046.             CSI ?26n           Keyboard Language
  3047.             CSI !p             Soft Terminal Reset
  3048.             ESC c              Hard Reset
  3049.             ESC ~              Map G1 into GR
  3050.             ESC n              Map G2 into GL
  3051.             ESC }              Map G2 into GR
  3052.             ESC o              Map G3 into GL
  3053.             ESC |              Map G3 into GR
  3054.             ESC N              Map G2 into GL for next char only
  3055.             ESC O              Map G3 into Gl for next char only
  3056.  
  3057.  
  3058.       In the following sequences, <c> refers to a single character
  3059.       selected from the Character Sets which follows:
  3060.  
  3061.             ESC (<c>           G0 is c
  3062.             ESC )<c>           G1 is c
  3063.  
  3064.  
  3065. Character Sets
  3066. ==============
  3067.  
  3068.       The following codes may be used to replace <c> in the above
  3069.       character set selection commands:
  3070.  
  3071.             B                  ASCII
  3072.             0                  Special Graphics (Line)
  3073.             A                  British
  3074.             4                  Dutch
  3075.             5 or C             Finnish
  3076.             R                  French
  3077.             9 or Q             French Canada
  3078.             K                  German
  3079.             Y                  Italian
  3080.             ' or E or 6        Norwegian/Dutch
  3081.             Z                  Spanish
  3082.             7 or H             Swedish
  3083.             =                  Swiss
  3084.             ESC *<c>           Set G2 Character Set
  3085.             ESC +<c>           Set G3 Character Set
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.                               ANSI Color Support
  3092.  
  3093.  
  3094.       PopTerm/NVT supports ANSI color commands sent from the host. When
  3095.       a color command is received, the program will display subsequently
  3096.       received characters using the new background and/or foreground
  3097.       colors which will become the configured colors for this session and
  3098.       will be shown on the Control Panel. If the colors are subsequently
  3099.       changed through the Control Panel, the Control Panel settings will
  3100.       override the last ANSI color command.
  3101.  
  3102.  
  3103. MS-DOS
  3104. ======
  3105.  
  3106.       To use ANSI color commands with the DOS version of PopTerm/NVT, you
  3107.       must select a terminal type of VT-102/AC or VT-220 via the Control
  3108.       Panel. If you select VT-52 or VT-102 as your terminal type, all
  3109.       color commands will be ignored. If you switch from VT-102/AC or
  3110.       VT-220 to VT-52 or VT-102, ANSI color information on the screen
  3111.       will be removed, and the screen will appear in the selected
  3112.       foreground and background colors.
  3113.  
  3114.  
  3115. Windows
  3116. =======
  3117.  
  3118.       To enable ANSI colors in PopTerm/NVT for Windows, check the ANSI
  3119.       Color box on the Terminal/Settings dialog box.
  3120.  
  3121.  
  3122. Underline Colors (DOS Only)
  3123. ===========================
  3124.  
  3125.       Since the PC cannot display underlines in color when using the
  3126.       standard font, PopTerm/NVT DOS allows the user to choose a color in
  3127.       which underline characters will be displayed. Since the
  3128.       application at the host end will not know what the underline color
  3129.       selection will be, it is possible that an ANSI color command could
  3130.       render underline characters unreadable. For example, if the user
  3131.       selects red as his underline color, and the host then sends a
  3132.       command for a white foreground and a red background, then
  3133.       underlined characters would appear as red-on-red spaces.
  3134.  
  3135.       To avoid this problem, PopTerm/NVT for DOS selects a new underline
  3136.       color for the user whenever an ANSI color command is received.
  3137.       This will override the value that is selected in the Control Panel.
  3138.       The underline color that PopTerm/NVT selects will always be
  3139.       different from the current foreground or background color.
  3140.  
  3141.       -----------------------------------------------------------------
  3142.        NOTE:  PopTerm/NVT for Windows displays true underlines.
  3143.       -----------------------------------------------------------------
  3144.  
  3145.  
  3146. ESCape Sequences
  3147. ================
  3148.  
  3149.       The ESCape sequence that can be sent from the host is in the
  3150.       standard VT-100 form,:
  3151.  
  3152.            ESC [ # ;...; # m
  3153.  
  3154.       where the #'s are replaced by one or more of the following
  3155.       parameters.
  3156.  
  3157.            Parameter           Attributes
  3158.            ----------------------------------------
  3159.             0                  All Attributes Off
  3160.             1                  Bold On
  3161.             4                  Underscore On
  3162.             5                  Blink On
  3163.             7                  Reverse Video On
  3164.       
  3165.             30                 Black Foreground
  3166.             31                 Red Foreground
  3167.             32                 Green Foreground
  3168.             33                 Yellow Foreground
  3169.             34                 Blue Foreground
  3170.             35                 Magenta Foreground
  3171.             36                 Cyan Foreground
  3172.             37                 White Foreground
  3173.             40                 Black Background
  3174.       
  3175.             41                 Red Background
  3176.             42                 Green Background
  3177.             43                 Yellow Background
  3178.             44                 Blue Background
  3179.             45                 Magenta Background
  3180.             46                 Cyan Background
  3181.             47                 White Background
  3182.  
  3183.  
  3184.       For example, the following sequence will cause the display to
  3185.       appear in a yellow foreground on a blue background:
  3186.  
  3187.            ESC [33;44m
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.                               Keyboard Remapping
  3194.  
  3195.  
  3196. Introduction
  3197. ============
  3198.  
  3199.       PopTerm/NVT allows you to remap the keyboard in order to modify the
  3200.       characters which are transmitted to your Unix host when keys are
  3201.       pressed. Map files start as editable ASCII text files (with the
  3202.       extension .SRC) which are then compiled by the KEYCOMP.EXE utility.
  3203.       The resulting binary files (with the extension .MAP) are used by
  3204.       PopTerm/NVT to perform keyboard mapping at runtime.
  3205.  
  3206.  
  3207. Default Map
  3208. ===========
  3209.  
  3210.       When started, PopTerm/NVT normally loads the default keyboard map
  3211.       file, KEYBOARD.MAP, which must be in the same directory as the
  3212.       program.
  3213.  
  3214.  
  3215. Command Line
  3216. ============
  3217.  
  3218.       You can specify a different keyboard map file on the command line
  3219.       using the following syntax under MS-DOS:
  3220.  
  3221.            PT /K<map_filename>
  3222.  
  3223.       or the following under Windows:
  3224.  
  3225.            POPTERM /K<map_filename> [<session_filename>]
  3226.  
  3227.       No filename extension should be specified, and there must be no
  3228.       space between the /K and the filename. If your keyboard map is
  3229.       named MYKEY.MAP, for example, your MS-DOS command line might be:
  3230.  
  3231.            c>pt /kmykey
  3232.  
  3233.       or, when using the Windows version:
  3234.  
  3235.            popterm /kmkey
  3236.  
  3237.            
  3238. Source File
  3239. ===========
  3240.  
  3241.       The file KEYBOARD.SRC supplied with PopTerm/NVT was used to create
  3242.       KEYBOARD.MAP. To modify PopTerm/NVT's keyboard mapping, you may
  3243.       either edit this source file or create one of your own.
  3244.  
  3245.       -----------------------------------------------------------------
  3246.        WARNING!  All keyboard functions in VT-102(/AC) and VT-220 modes
  3247.                  depend upon the keyboard map file. If the mappings for
  3248.                  the function keys, etc., are not defined within it, 
  3249.                  PopTerm/NVT will not operate correctly. If you wish to
  3250.                  change the mapping of a key, do not delete the other
  3251.                  mappings in KEYBOARD.SRC. If a keyboard map file is 
  3252.                  not present, PopTerm/NVT will not start.
  3253.       -----------------------------------------------------------------
  3254.  
  3255.       -----------------------------------------------------------------
  3256.        HINT:  If you want to change the keyboard map, you should first
  3257.               make a copy of KEYBOARD.SRC under another name and edit 
  3258.               that copy.
  3259.       -----------------------------------------------------------------
  3260.  
  3261.       KEYBOARD.SRC is a list of the scan codes for each PC key
  3262.       combination and the string of characters which are to be sent when
  3263.       the associated key is pressed.
  3264.  
  3265.  
  3266. Key Values
  3267. ==========
  3268.  
  3269.       To determine the scan code for any keystroke combination, run the
  3270.       MS-DOS program KEYTEST.EXE:
  3271.  
  3272.            c>keytest
  3273.  
  3274.       -----------------------------------------------------------------
  3275.        NOTE:  Do not attempt to run KEYTEST.EXE from Windows. Exit 
  3276.               Windows and return to MS-DOS before running KEYTEST.EXE.
  3277.               KEYTEST will display the scan codes for each keystroke
  3278.               combination you press until you press ESCape.
  3279.       -----------------------------------------------------------------
  3280.  
  3281.  
  3282. Which Table?
  3283. ============
  3284.  
  3285.       If the first value for a given key combination is preceded by an
  3286.       equal sign ("="), use the Table-A Method described below when
  3287.       remapping that key combination. If the value is not preceded by an
  3288.       "=", use the Table B Method. For example, if you run KEYTEST.EXE
  3289.       and press the F7 key, you will see that the scan code for the F7
  3290.       key is "0x41". Because the value is not preceded by an equal sign,
  3291.       you should use the Table B Method to remap this key.
  3292.  
  3293.  
  3294. Foreign Keyboards
  3295. =================
  3296.  
  3297.       When creating a map for a non-U.S. keyboard, set the KEYBOARD= item
  3298.       in the source file to the appropriate value from the list below:
  3299.  
  3300.          3=Swiss/French
  3301.          4=Swiss/German
  3302.          5=Canadian/English
  3303.          6=Katakana
  3304.          7=Italian
  3305.          8=Canadian/French
  3306.          9=US
  3307.          A=UK
  3308.          B=French
  3309.          C=German
  3310.          D=Swedish/French
  3311.          E=Spanish
  3312.          F=Danish/Norwegian
  3313.  
  3314.       The default is
  3315.  
  3316.            KEYBOARD=9
  3317.  
  3318.       for the US keyboard layout. If your are modifying the mapping to
  3319.       correspond to the French keyboard layout, change this to
  3320.  
  3321.            KEYBOARD=B
  3322.  
  3323.       -----------------------------------------------------------------
  3324.        NOTE:  If you are using a non-U.S. keyboard, you may need to
  3325.               load the MS-DOS KEYB.COM program or other keyboard and 
  3326.               display programs. Refer to your MS-DOS documentation for
  3327.               additional information.
  3328.       -----------------------------------------------------------------
  3329.  
  3330.  
  3331. Restrictions
  3332. ============
  3333.  
  3334.       Both PopTerm/NVT and Microsoft Windows make use of a number of
  3335.       Alt-<key> combinations. For this reason, PopTerm/NVT does not
  3336.       allow remapping of Alt-<key> combinations using printable
  3337.       characters (letters, numbers or punctuation characters).
  3338.  
  3339.       -----------------------------------------------------------------
  3340.        WARNING!  Most PopTerm/NVT key combinations are defined solely
  3341.                  by their mappings in the map file. If a key's mapping
  3342.                  is omitted from the map file, the key will have no 
  3343.                  effect when pressed. Always create a new map by 
  3344.                  editing a copy of KEYBOARD.SRC, and only delete a
  3345.                  mapping if you truly want the associated key to have
  3346.                  no function.
  3347.       -----------------------------------------------------------------
  3348.  
  3349.  
  3350. Source File Syntax
  3351. ==================
  3352.  
  3353.       Any text in the source file before a line which begins with a "!"
  3354.       will be written to the beginning of the output file, followed by a
  3355.       ^Z. This allows map files to be TYPEd at the DOS prompt, causing
  3356.       valuable information to be displayed. Typical text includes
  3357.       revision and copyright information.
  3358.  
  3359.       Numeric values can be entered using standard "C" syntax in octal
  3360.       (beginning with "0"), decimal (beginning with a non-zero number),
  3361.       or hex (beginning with "0x"). KEYBOARD.SRC, as supplied, has all
  3362.       values listed in hex.
  3363.  
  3364.       Comments begin with a ";". If not starting in column one, you must
  3365.       have a space before the ";".
  3366.  
  3367.  
  3368. Table "A" Method
  3369. ================
  3370.  
  3371.       If KEYTEST returns a value preceded by "=", you should remap the
  3372.       key combination using a statement with the following syntax:
  3373.  
  3374.            =<val> %<scancode> [[A][S][C][N][K]] <action>
  3375.  
  3376.       where <val> is the 1-byte value returned by KEYTEST and
  3377.       <action> is described later. The %<scancode> is the value
  3378.       shown in square brackets ("[]") by KEYTEST.
  3379.  
  3380.       The %<scancode> is used to differentiate between two keys that
  3381.       return the same initial <value>, but must be distinguished in
  3382.       order to cause different actions. It may be followed by "A", "S",
  3383.       "C", "N", or "K" to represent Alt, Shift, Control, NumLock, or
  3384.       K-mode respectively. Note that "A", "S", "C", "N", and "K" may
  3385.       appear in any order, and may be in upper or lower case. "K" mode
  3386.       is described later.
  3387.  
  3388.       For example, the backspace key and ^H both return the code "=0x08"
  3389.       which would normally transmit a ^H character. If the terminal
  3390.       should generate an ASCII rubout (0x7f) instead for the backspace
  3391.       key, then use the following statements to resolve it:
  3392.  
  3393.            =0x08  %0xe      0x7f  ;backspace: rubout
  3394.            =0x08  %0x23  c  0x08  ;control-h: hex 8
  3395.  
  3396.       If KEYTEST returns a value which is preceded by an "=", then this
  3397.       remap method must be used. Otherwise, use the Table "B" method as
  3398.       follows.
  3399.  
  3400.  
  3401. Table "B" Method
  3402. ================
  3403.  
  3404.       Keys which do not generate codes preceded by "=" must be identified
  3405.       by the following syntax:
  3406.  
  3407.            <scancode> [A][S][C][N][K] <action>
  3408.  
  3409.       where <scancode> is the value shown by KEYTEST, "A", "S", "C",
  3410.       "N", and "K" refer to Alt, Control, Shift, NumLock, and K-mode
  3411.       respectively, and <action> is described later. Note that "A",
  3412.       "S", "C", "N" and "K" may appear in any order, and may be in upper
  3413.       or lower case.
  3414.  
  3415.  
  3416. K-Mode
  3417. ======
  3418.  
  3419.       On VT-100 and -200 series terminals there is a special mode for the
  3420.       keypad called the Keypad Application Mode (KAM). When KAM is
  3421.       turned on by an application, the keypad can be used for performing
  3422.       special functions defined by the application.
  3423.  
  3424.       K-mode is handled in the keyboard map the same way Shift, Control,
  3425.       and Alt are handled, except a "K" is used instead of an "S", "C",
  3426.       "N", or "A". This makes combinations such as KS, KCA, etc.,
  3427.       possible. It will only work with the keypad keys, however, and it
  3428.       will be ignored if applied to any other key.
  3429.  
  3430.       Because the setting of K-mode can only be done by an application,
  3431.       the user will seldom have a reason to change this in the map. One
  3432.       reason to do so might be to allow a key to act as if it were not in
  3433.       K-mode while the others are handled normally. For example, the
  3434.       user might want the 5 key to send a "5" instead of sending the
  3435.       normal K-mode character string "ESC Ou" for that key.
  3436.  
  3437.  
  3438. N-Mode
  3439. ======
  3440.  
  3441.       N-mode allows proper operation of the numeric/cursor keypad while
  3442.       the NumLock key is on. It is highly unlikely that you will need to
  3443.       either modify the N-mode keys listed in KEYBOARD.SRC or create new
  3444.       N-mode mappings, but these N-mode mappings must be present in
  3445.       KEYBOARD.SRC for the keypad to operate properly.
  3446.  
  3447.  
  3448. Actions
  3449. =======
  3450.  
  3451.       The results of a keystroke are an <action> which may consist of
  3452.       transmitting one or more bytes of data. There are also special
  3453.       built-in <actions> which are indicated by an asterisk ("*")
  3454.       followed by a number between 1 and 20.
  3455.  
  3456.       If an <action> does not start with an asterisk, it is assumed to
  3457.       be one or more bytes which are to be transmitted by PopTerm/NVT
  3458.       when the specified keystrokes are detected. Simply specify the
  3459.       string of byte values, up to a maximum of nine such values. For
  3460.       example, the "F1" function key is defined as:
  3461.  
  3462.            0x3b 0x1b 0x4f 0x50 ;F1 - ESC OP
  3463.  
  3464.       To explain, the <scancode> is "0x3b" and the key will transmit
  3465.       three bytes, 0x1b, 0x4f, and 0x50 (an ESC, followed by 'O' and
  3466.       'P').
  3467.  
  3468.       *1 though *6 refer to the six user-programmable macros which can be
  3469.       set on the Control Panel screen (Alt-P) in PopTerm/NVT for MS-DOS
  3470.       or the Terminal/Keyboard Macros menu/dialog box in PopTerm/NVT for
  3471.       Windows. Macros are strings of up to 30 characters which will be
  3472.       sent to the host when the keys to which they are assigned are
  3473.       pressed.
  3474.  
  3475.       *7 and *8 are for shifting the display right or left when
  3476.       PopTerm/NVT is set for 132 column mode in the MS-DOS version of
  3477.       PopTerm/NVT. These are initially set to control-right-arrow and
  3478.       control-left-arrow.
  3479.  
  3480.       *11 though *20 switch between sessions in the MS-DOS version of
  3481.       PopTerm/NVT. *11 is for session one, *12 is for session two, and
  3482.       so on. With the default key mappings, Alt-F1 (which has *11
  3483.       assigned to it) would switch to session one, Alt-F2 (with *12)
  3484.       would switch to session two, and so on.
  3485.  
  3486.       *7 through *20 have no purpose in the Windows version of
  3487.       PopTerm/NVT.
  3488.  
  3489.  
  3490. Multiple Entries
  3491. ================
  3492.  
  3493.       KEYCOMP uses the first occurrence of a key listed in KEYBOARD.SRC
  3494.       for a mapping. In other words, if a key is listed more than once,
  3495.       only the first one encountered will be used. For example, if the
  3496.       following two lines were in KEYBOARD.SRC, only the first one,
  3497.       mapping the F4 key to PF4, would be used. The second one mapping
  3498.       F4 to macro four would be ignored.
  3499.  
  3500.            0x3e  0x1b  0x4f  0x53  ;F4 - ESC OS
  3501.            0x3e  *4                ;Macro 4
  3502.  
  3503.       If you find that a key mapping doesn't seem to work, try looking
  3504.       for a duplicate earlier in the file.
  3505.  
  3506.  
  3507. Running KEYCOMP.EXE
  3508. ===================
  3509.  
  3510.       To run the compiler, use the following MS-DOS command:
  3511.  
  3512.            KEYCOMP [<source_file>]
  3513.  
  3514.       The output is always placed in the file KEYBOARD.MAP and may be
  3515.       renamed. If <source_file> is not specified, KEYBOARD.SRC is
  3516.       assumed.
  3517.  
  3518.